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I. THE NEED FOR SCRIPT ANIMATION LANGUAGES 


A. INTRODUCTION 


The Graphics and Video Laboratory of the Computer Science Department at the 
Naval Postgraduate School (NPS) has a long history of developing 3D visual simulation 
systems on inexpensive, commercially available graphics workstations [Ref. 10]. The 
visual simulators developed in the Graphics and Video Laboratory include the FOG-M 
missile simulator, the VEH vehicle simulator, the Airborne Remotely Operated Device 
(AROD), the Moving Platform Simulator series (MPS-1, MPS- 2, and MPS-3), the High 
Resolution Digital Terrain Model (HRDTM) system, the Forward Observer Simulator 
Trainer (FOST), the NPS Autonomous Underwater Vehicle simulator (NPSAUV), and the 
Command and Control Workstation of the Future system (CCWF). Current visual 
simulation efforts are focused on the NPSNET system, a 3D visual simulation system that 
utilizes SIMNET and DMA databases. 

NPSNET is a real-time, 3D visual simulation system capable of displaying various 
types of vehicles - ground, ships, and aircraft [Ref. 10]. The system is capable of 
displaying additional objects such as missiles, buildings, trees, and environmental effects, 
such as fog and smoke. Objects are represented initially by pre-defined 3D icons stored in 
Object File Format (OFF) [Ref. 9]. 3D icons are geometric descriptions of 3D objects. 
Vehicle movements in NPSNET are controlled by mouse, spaceballs, and button/ 
dialboxes. In addition, vehicles can be driven interactively from other workstations by 
means of message packets via Ethernet. 

In any simulator, the backbone of the system is its internal data structures for 


modeling the state of the world [Ref. 10]. It is from the world state information that visual 


displays are generated. Continuous and transient events are referred to as task-level 
behaviors in virtual world systems [Ref. 1]. Continuous events are dynamic changes in 
motion of 3D icons. Transient events are ene changes of appearances in virtual 3D 
icons, such as explosions and collisions. 

When sufficient numbers of actual interactive players are not available, the Graphics 
and Video Laboratory requires two methods for generating autonomous players to 
populate the world - semi-automated forces and scripting [Ref. 10]. Currently in 
development, semi-automated forces provide intelligent behavioral models to autonomous 
players via_ parallel processing and the network. Scripting provides a programmable 
mechanism to add autonomous agents or to change task-ievel behaviors of 3D icons. 

The script system, the Object Animation Scnpt Interpretation System for NPSNET 
(NPSNET-OASIS), was developed to meet the requirements of scripted autonomous 
players. Designed using object-oriented methodologies, NPSNET-OASIS provides the 
capabilities to record and playback scripts of task-level behaviors. Scnpts in NPSNET- 
OASIS are generated as sequences of events in uniform order based on timestamps. 
Unlike current systems which are coded in standard C, NPSNET-OASIS is programmed 
in C++, thus allowing reusability and extensibility. Several instances of NPSNET-OASIS 


can be integrated into NPSNET, allowing the simultaneous execution of multiple scripts. 


B. BACKGROUND 


There are two interaction paradigms in virtual world systems - guiding and 
programming [Ref. 1]. Guiding is interaction with objects from built-in procedural 
support and specially-designed graphics hardware. Programming is interaction with 
objects using special-purpose simulation software for algorithmic description and control. 

The principles of software engineering are applied to natural script languages in an 


effort to provide a more flexible, extensible, and efficient interactive tool for visual 


simulators [Ref. 5]. Libraries of scripts can be generated and reused, allowing fast 
prototyping of simulated engagements and tactics. Simple in design and use, scripts are 
basically procedures for controlling 3D icons. Combining scripts to create larger ones, 
Supports modular scripting in a high-level of programming. In LISP-based systems, the 
rules of the script language are extensible so that new animation procedures and primitives 
can be added to the system. Easier to learn than complex languages, script languages can 
develop animation scripts faster than a functionally equivalent Ada or C program. 

The basis for our research in script systems is on three earlier systems - ASAS, PDI, 
and MANUS. Based on the LISP language, Actor/Scriptor Animation System (ASAS), 1s 
a full programming language system for animation and graphics [Ref. 6]. ASAS supports 
independent program structures called actors, and includes a set of geometric objects and 
operators. Geometric objects include data types such as vectors, colors, polygons, solids, 
and lights. Actors are responsible for geometric objects in an animation sequence. 
Geometric operators are the tools the animator uses to shape, move, and orient geometric 
objects. 

Influenced by ASAS, Pacific Data Images (PDI) developed a script system on top of 
the C programming language for creating animation in the entertainment field [Refs. 3, 5]. 
The PDI script system supports complex modeling, transformations, and motion. At each 
production stage, the script is updated to reflect production changes, and to incorporate 
new models and motion data from other parts of script system. 

BOLIO, an integrated graphical simulation platform (IGSP), provides users tools to 
interact in simulation of task-level behaviors, and event-driven processes in virtual worlds 
[Refs. 1, 8]. A component of BOLIO, MANUS, provides the built-in language and 
processor for associating objects and processes in defining task-level behaviors. 


Programmers have access to primitive operations of kinematics and dynamics in a 


modular function library. Complex scripts are used for testing and debugging various: 


simulation modules, or for defining virtual environments 


C. SUMMARY OF CHAPTERS 

The development of NPSNET- OASIS involves understanding of required task-level 
behaviors of NPSNET and other 3D visual simulators of the Graphics and Video 
Laboratory. In Chapter II, the design of the script system is discussed. Chapter Ill 
discusses the overview of NPSNET-OASIS. The interaction of NPSNET-OASIS with 
NPSNET is discussed in Chapter IV. Limitations and future directions are the subjects of 
Chapter V. Appendices include syntax for script events and script options, listings of 
script results and script errors, sample scripts, and object class descriptions for NPSNET- 


OASIS. 


Il. DEVELOPMENT OF NPSNET-OASIS 


A. DESIGN CRITERIA 


The goal of NPSNET-OASIS is to build a scripting system that is reusable and 
extensible. In addition, NPSNET-OASIS must be simple for system integration. Previous 
3D visual simulators in the Graphics and Video Laboratory were developed with traditional 
programming languages such as C, and are not easy to maintain. Whenever, a modification 
is made, the entire system is affected. The design of NPSNET-OASIS must be capable of 


being adapted easily as modifications are made to NPSNET. 


B. OBJECT-ORIENTED DESIGN 


The concept of object-oriented design (OOD) involves solving problems by 
identifying the real-world objects of the problem, and the processing required of those 
objects [Ref. 2]. For this reason, all components of NPSNET-OASIS are represented as 
objects. Classes in object-oriented design, distinguished in italics text, are templates for 
categories of objects, and provide the means for creating objects. Because objects serve as 
data abstractions, classes must include data structure definitions and the processing code 


for instances of those data structures. 


1. Class Hierarchy 


OasisObject is the root class of the NPSNET-OASIS class hierarchy, as other classes 
in the hierarchy are derived from it. The main descendants of OasisObject - 
OasisSystemObject and OasisEventObject, represent the main components of NPSNET- 
OASIS (Figure 2.1). OasisSystemObject represents the base class for all system 
components in script processing, script generating, and script sorting. OasisEventObjects 


represents the base class for all task-level behaviors in 3D icons. For illustrative purposes, 


classes of NPSNET-OASIS are segmented from the total class hierarchy, and are 


represented as ellipses with arrows pointing to descendants. 


2. Event Objects 


Each ScriptEvent is composed of an EventObject, EventPosition, TimeStamp, and 
EventAttribute, which are descendants of OasisEventObjects (Figure 2.2). EventObjects 
provide identification of 3D icons in events, and EventPositions provide the locations of 
the events. For every ScriptEvent there is a TimeStamp, which provides the time 
mechanism to synchronize all events in uniform order. For additional information in 
supporting task-level behaviors of 3D icons, EventAttributes are used to represent the 
change of continuous and transient events (Figure 2.3). 

Presented in Figure 2.4 are the six classes of script events - VehicleEvent, 
WeaponEvent, MiscObjectEvent, EnvironmentEvent, ScriptOption, ScriptComment, and 


ScriptOption. ScriptComment and ScriptOption do not represent script events. However, 


OasisObject 
OasisEventObject OasisSystemObject 


Figure 2.1 Root Class of NPSNET-OASIS Class Hierarchy 
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Figure 2.2 Ancestors of Class ScriptEvent 
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Figure 2.3 Descendants of Class EventAttribute 


script events are supported by them for descriptive narrations in script files and script 
synchronization. Communicating with script events, ScriptObjects are the interfaces for 
passing messages of task-level behaviors to and from 3D icons. ScriptObjects interact with 


virtual world systems for controlling and recording continuous and transient events. 


3. System Objects 


There are four parent classes for OasisSystem - ScriptFile, ScriptProcessor, 
ScriptGenerator, and TimeKeeper (Figure 2.5). Classes are derived from 
OasisSystemEvents for supporting system requirements of NPSNET-OASIS. ScriptFiles 
provide the mechanism for interacting script files with script systems. EventProcessor 1s 
the base class for the required event processors to the ScriptProcessor. ScriptProcessor 1s 
the tool for interpreting and processing of all script files. The script writer of NPSNET- 
OASIS, the ScriptGenerator, records all script objects to a script file. The last parent class, 


the TimeKeeper, provides the system times for processing and recording script files. 
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Figure 2.4 Ancestors of Class ScriptObject 
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Figure 2.5 Ancestors and Descendants of Class OasisSystem 


Derived from OasisSystem, are two additional object classes for NPSNET-OASIS 
(Figure 2.5). OasisScriptPreprocessor, is a preprocessor for validating script files prior to 
processing. Script errors are displayed for further script modification. The second object 
class, OasisScriptSorter, provides the sorting of script events based on time stamps. This 


tool ensures all script events are in uniform order. 


C. NPSNET-OASIS SCRIPT FORMAT 


All script files for NPSNET-OASIS are in text-based format allowing the user to use 


any standard text-editor for script editing and creation (Figure 2.6). It is easier to edit task- 
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Description: Sample script of two M-1 tanks 
Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 
Author: Phillip West 


KKKKKKKKKKK KK KKK KEK KKK KKK KK KKK KKK KK EK KKK KKK KKKEKKKKKKKKKKKKKKEKKKKKE / 


SCRIPT TIME REFERENCE relative 
SCRIPT _LOCATION 79A-DN 


/* Activate clouds with velocity 5.0 km/h, heading 270.0 west */ 
ENVIRONMENT ACTIVATE 5010499 Cloud 270.0 5.0 34536783 1000.0 30.0 


/* Activate two M-1 tanks */ 
VEHICLE_ACTIVATE 5010001 M1 090.0 40.0 345678 0.0 40.0 
VEHICLE ACTIVATE 5010002 M1 090.0 40.0 345678 0.0 45.0 


/* Change headings of M-1 tanks */ 
VEHICLE HEADING 5010001 135.0 344955 0.0 2:0.0 
VEHICLE HEADING 5010002 120.0 345958 0.0 2:5.0 


/* M-1 tanks passing by a palm tree */ 
OBJECT ACTIVATE 5010003 PalmTree 345700 0 4:0.0 
OBJECT _DEACTIVATE SOLO00355:.35.50 


/* Change velocities of M-1 tanks */ 


VEHICLE SPEED 5010001 5.0 344801 0.0 6:0.0 
VEHICLE SPEED 5010001 5.0 344803 0.0 7:25.0 

/* M-1 tanks passing by a building */ 

OBJECT ACTIVATE 5010004 Building 345700 0.0 8:10.0 


OBJECT _DEACTIVATE 5010004 9:40.0 
/* Deactivate M 1 tanks */ 

VEHICLE DEACTIVATE 5010001 9:45.0 
VEHICLE DEACTIVATE 5010002 9:50.0 


/* Deactivate clouds */ 
ENVIRONMENT ACTIVATE 5010499 10:0.0 


/* End Of Script */ 


Figure 2.6 Sample Script 


level behaviors of 3D icons in ASCII text, than it is in binary format. Each script statement 
is required to be on a separate line. Since most text editors are capable of handling lines up 
to 132 columns, there is no reason for a single script statement to not fit all on one line. 
There is no limit on number of lines per script file. 

All script event statements in NPSNET-OASIS contain a procedural operator and the 


required arguments for the procedural operator (Figure 2.7). Procedural operators are 


OBJECT ACTIVATE 100 tree 79A-DN-123678 0,0 1:00.90 


Procedural Arguments 
Operator 





Figure 2.7 General Syntax for Script Statements 


classified into five groups - vehicle, weapon, object, environment, and script. All NPSNET- 
OASIS procedural operators begin with the group name for rapid parsing and simplicity. A 
listing of all script events can be found in Appendix A. 

In the interest of clarity and readability, blank lines and comments are permitted 
between statements. Comments are used to explain or describe the script event. Whenever 
the symbol ‘/*’ is encountered on a line, all characters from that point on, until the symbol 
‘*/’ is reached, is considered to be a comment. 

Case is not important in procedural operators and required arguments. All characters 
are converted to lower case for parsing and extraction. The only time case is important, is 
when characters in script file names are case sensitive for UNIX based input and output 


disk operations. 
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I. OVERVIEW OF NPSNET-OASIS 


A. SCRIPTING TOOLS 


The NPSNET-OASIS system communicates with three scripting tools - the script 


processor, the script generator, and the timekeeper (Figure 3.1). Each tool is independent of 


NPSNET-OASIS 
SYSTEM 


Pal Time Keeper 


SS 


Script Processor Script Generator 





Figure 3.1 The NPSNET-OASIS System 
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the other. The integration of the scripting tools, provides animators the required 


mechanisms to record and playback scripts. 


1. Script Processor 


Hidden from the user, all functions of the script processor are accessed from the 
NPSNET-OASIS system. Functions include reading script objects and assigning script files 
to process. There is only one script file active in the script processor at any given instance. 
However, multiple processors are allowed. On end of file, the script processor can be 
assigned another script file from the NPSNET-OASIS system. | 

The script processor returns a script result after each read. Script results are based on 
valid script statements or errors reading the script file. File errors are treated as end of 
scripts or invalid script files. When an error occurs for a script statement, a message 1s 
displayed on the standard output device indicating type of error, followed by line number 
and name of current script file (Figure 3.2). Messages provide users a tool for debugging 


scripts. Description of script results and script errors are contained in Appendix A. 


[Line 10] of file ‘scri 


Line Number Name of Script File Type of Error 





Figure 3.2 Error Message 


Script statements are read in line for line by the script processor. When blank lines are 
encountered, the script processor ignores them, and continues to read the script file. 
Beginning with the symbol ‘/*’ script comments are continuous script lines containing 
information about script events or script options. The script processor treats each line as a 


comment until the termination symbol ‘*/’ is reached. The user must be careful in using 


Zz 


script comments. A script comment with no termination symbol will include valid script 
events until end of file. Script lines containing script events or script options are valid only 
when both procedural operators and the required arguments are valid. The number of 
arguments for each procedural operator are fixed. Thus, incomplete or extra arguments will 
make the script line invalid. In addition, incomplete format of a required argument will 


preempt an error message by the script processor. 


2. Script Generator 


The script generator’s primary purpose is to write script objects to an output file in 
NPSNET-OASIS script format. Error checking does not exist since script objects contain 
default values for all values not assigned in events. All script files generated from the script 
generator are valid files for script processing. When several script files exist, a library can 
be created by including several script files into one script. There are no specified maximum 


number of lines per script file. The only limitation is the space available on disk. 


3. System Timekeeper 


As timestamps are processed for each script event, the system timekeeper adjusts them 
for simulator interaction. Timestamps for each script event are assumed relative to the start 
time of the input script file. When absolute, timestamps are relative to the start time of 
NPSNET-OASIS system. The timekeeper uses the system clock of the graphics 
workstations for all assignments of start times. Times received from system clocks are 
based on total seconds and total microseconds since January 1, 1970 [Ref. 7]. 

There are two types of clock references - system and user. The difference between the 
two, is that system clock reference is actual system time, and user clock reference is the 
time selected by the user in seconds and microseconds. When selected in user clock 
reference, the user has the option to change the start time for the NPSNET-OASIS system. 
When changed, the timekeeper adjusts the new start time with the system clock. In addition, 


the start times for the input script file and output script file are also changed to the same 


he 


Start time as the NPSNET-OASIS system. When writing script files, timestamps are always 
reference to the start time of the output script file. 
In Figures 3.3 and 3.4, timestamp adjustments are illustrated for system clock 


reference and user clock reference. The timestamp is converted to total seconds and total 


System Start Time . 
00:00:00 Sept 1, 1991 Timestamp in Relative 


Total Secs 


683697600 | 500000 





imestamp of 10:01:05.5 


imestamp of 10:01:05.5 


Total Secs Usecs 







Input Script Start Time 
00:00:10 Sept 1, 1991 


Total Sees 


683697610 | 100000 


Figure 3.3 Illustration of Timestamp Adjustment Based on System Clock 














System Start Time Timestamp in Relative 


Total Secs 


Total Secs 


imestamp of 10:01:05.5 
























Timestamp in Absolute 
Total Secs 


imestamp of 10:01:05.5 
Usee 






Figure 3.4 Illustration of Timestamp Adjustment Based on User Clock 
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microseconds. The total seconds and microseconds are used for timestamp adjustments 
based on either relative or absolute time reference. In relative time reference with the 
system clock, the timestamp is added to the start time of the input script file. In absolute 
time reference, the timestamp is added to the start time of the NPSNET-OASIS system. The 


same procedure is also applied to the user clock reference. 


B. STRUCTURE OF SCRIPT EVENTS 


Each script event has a 3D icon identification, a position, a timestamp and attributes 
to describe a task-level behavior event. Users of NPSNET-OASIS must be familiar with 


the data structures and the information contained in them. 


1. 3D Icon Identification 


3D icon identifications include an object number, a host number, an object description, 
and an object status. Object numbers are four digit values assigned to 3D icons by the visual 
simulator to distinguish from other 3D icons. Host numbers are three digit values used in 
identifying visual simulators in a network. When combined, a host number and an object 
number provide an unique identification number to a 3D icon (Figure 3.5). Object 
descriptions are descriptive names of 3D icons. NPSNET requires them for associating 
OFF files for visual display. Supplementing world state information, object status is a 


description of the current state on a 3D icon. 


501 1234 


Host Number = | Object Identification 


Number 





Figure 3.5 The 3D Icon Identification Number 
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2. Event Position 


Positions for a script event include grid coordinates and an elevation. Elevation, 
represented in meters, is the altitude of an area above sea level. The primary military grid 
reference system in the United States, the Universal Transverse Mercator (UTM), is a 
world wide plane coordinate system based on the metric standard [Ref. 4]. The grid 
coordinate system of UTM is adopted in NPSNET-OASIS (Figure 3.6). Each UTM grid 
zone iS a square area of six degrees in longitude by eight degrees in latitude. UTM 
coordinates are designated by two or three characters. The last character, in alphabetic 
notation, represents the latitude offset, and the beginning characters, in numeric notation, 
represents the longitude offset. To further identify locations in each UTM gnid zone, the 
U.S. Army created the MGRS [Ref. 4]. MGRS subdivides UTM grid zones into 100,000 
meter Square areas designated by two letters. To complete the MGRS grid, UTM easting 
and northing are used to designate which square meter area. Coordinates are in even digits 
where the first half representing easting, and the second half, northing. Precision in UTM 
coordinates requires five digits for easting and northing. In NPSNET-OASIS, easting and 
northing coordinates with digits less than five, are appended with additional zeros (Figure 


Se 


T9A -DN -12345 12345 


+ 1) a 


Gridzone MGRS Easting Northing 





Figure 3.6 UTM Coordinate Position 
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Appended Zeros 


79A -DN -12300 12306 
a | 


Gridzone MGRS Easting Northing 





Figure 3.7 UTM Coordinate Position With Padded Zeros 


3. Timestamp 


Timestamps are based upon the 24-hour clock metaphor where times are represented 
as strings [Ref. 1]. Each field of the timestamp string is represented by numeric characters 
with leading zeros being optional. In Figures 3.8a-c, hours, minutes, and seconds of the 
timestamp string are interpreted from right to left. Microseconds are interpreted from left 
to right (Figure 3.8). Used in event scheduling, timestamps indicate when to execute the 
event. In time delays, timestamps indicate the time durations of the script pauses, or the 
time to begin reading scripts. In Figure 3.8, timestamps are listed in formats acceptable to 


NPSNET-OASIS. 


4. Event Attributes 


Representing properties of continuous and transient events, attributes provide 
additional information on script events. Attributes enable a 3D icon to be unique among 
other 3D icons in simulation. Information such as headings and velocities of 3D icons are 
affected by state changes of continuous events. Appearances of 3D icons are affected by 
state changes of transient events. An example of a transient event is an explosion of a 3D 
icon. The attributes for this event require the description type and the bounding area of the 


explosion. See Appendix I for description of event attributes. 


17 


Microseconds 


Microseconds 


Seconds Microseconds 


Microseconds 





Figure 3.8 Timestamp Formats 


C. SCRIPT OPTIONS 


Script options, or directives, are used in script files for file operations, script system 
defaults, and assigning values for timestamp adjustments. From Figure 2.6, the script is 
modified to include all the script options available to NPSNET-OASIS (Figures 3.9 and 


3.10). Syntax for each script option is listed in Appendix A. 


1. Script_Abort 


Normal termination of NPSNET-OASIS requires all statements in the input script file 


to be processed. However, the animator has the option to terminate the script by inserting 
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[EEK KKEKKEKKKEKKEKKEKEKKKEKKKEKKEKE KEKE KEKE EKKEKEKKEKKEKKKEKKKEKKKEKKKEKKEKEKKKKE 


Description: Sample script of two M-1 tanks ‘script.m1’ 
Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


KAKKKKKKKKKKKKKEKKKKKKKKKKKKKEKKKKKK KK KEK KKK KKKKKKKKKKKKKKKKKKKKKKKKKKK / 


/* Assign timestamp reference relative to start time of input script */ 
SCRIPT TIMESTAMP relative 


/* Assign default UTM gridzone and MGRS */ 
SCRIPT LOCATION 11S-DN 


/* Assign time factor of 50 percent for all timestamps */ 
SCRIPT TIME FACTOR 0.5 


/* Assign time adjustment value of 10 seconds for all timestamps */ 
SCRIPT_TIME ADJUSTMENT 10.0 


/* Activate clouds with velocity 5.0 km/h, heading 270.0 west */ 
ENVIRONMENT ACTIVATE 5010500 Cloud 270.0 5.0 34536783 1000.0 30.0 


/* Activate two M-1 tanks */ 
VEHICLE ACTIVATE 5010001 Mi 090.0 40.0 344955 0.0 40.0 
VEHICLE ACTIVATE 5010002 M1 090.0 40.0 345958 0.0 45.0 


/* Change headings of M-1 tanks */ 


VEHICLE HEADING S0gGg001 135-0 344801 0.0 2:0.0 
VEHICLE HEADING 5010002 120.0 344803 0.0 2:5.0 

/* Change velocities of M-1 tanks */ 

VEHICLE SPEED 5010001 5.0 344670 0.0 6:0.0 
VEHICLE SPEED 5010001 5.0 344677 0.0 7:25.0 

/* M-1 tanks passing by a building */ 

OBJECT ACTIVATE 5010004 Building 344701 0.0 8:10.0 


OBJECT _DEACTIVATE 5010004 9:40.0 


/* Script message for advance warning of upcoming script events */ 
SCRIPT MESSAGE Activating column of jeeps 


/* Script call for column of jeeps */ 
SCRIPT CALL SCript—2eml 


/* Continue script with next script file */ 
SCRIPT CHAIN script-1.ml 


Figure 3.9 Sample Script With Script Options 
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[RRR KKK KKK EKER KK KKK KKK KKK KKK KKKKKKKKKKKEKEEKEKEKEKEEKEEKKKKKKKKKKKKK KKK KKK KKK 


Description: Sample script of two M-1 tanks ‘script-1.m1’ 
Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


RHEE KK KEKE KEKE KEK KEK KKK KKK KKK KEKE KK KEK KEKE KKKKKKEKEKEKEEEKEKKKKKKKKKKKKKKKE / 


/* M-1 tanks passing by a palm tree */ 
OBJECT_ACTIVATE 5010003 PalmTree 345700 0.0 22:0.0 
OBJECT DEACTIVATE 5010003 22:35.0 


/* Change velocities of M-1 tanks */ 
VEHICLE SPEED 5010001 5.0 345670 0.0 26:0.0 
VEHICLE SPEED 5010001 5.0 345677 0.0 27:25.0 


/* Deactivate M 1 tanks */ 
VEHICLE_DEACTIVATE 5010001 29:45.0 
VEHICLE DEACTIVATE 5010002 29:50.0 


/* Deactivate clouds */ 
ENVIRONMENT ACTIVATE 5010500 30:0.0 


/* Script delay for duration of 5 minutes prior to termination */ 
SCRIPT DELAY 5:0.0 absolute 


/* Write to output script file message for next script processing */ 
SCRIPT FILE WRITE SCRIPT MESSAGE End of Script 


/* Terminate script */ 
SCRIPT ABORT 


[RRR KK KEKE KKK KKK KEKE KKK KEE KKK KKK KKK KKK KKK KKK KKEKKKKKKKEKKKKKKKKKKK 


Description: Sample script of multiple jeeps ‘script-2.m1’ 
Host Id Number: 501 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


KKK KKK KKK KKK KK KK KKK KKK KKK KKK KKK KKK KEKE KKK KEKE KKK KKEKKKKKKEKKKKKKKKEKE / 


/* Activate jeep vehicle */ 
VEHICLE ACTIVATE 5010010 Jeep 090.0 40.0 345678 0.0 10:0.0 


/* Repeat script for 10 iterations with total 11 separate vehicles */ 
SCRIPT_REPEAT 101 1:00 


Figure 3.10 Sample Script With Script Options 
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SCRIPT_ABORT. This script directive has no arguments. When encountered, all script 
files are closed, and a script result of END_OF_SCRIPT is returned to the system. 


2. Script Call 
The directive SCRIPT_CALL is a subscript call, similar to a procedure call in a high- 


level programming language. The argument for this directive is a string containing the 
script file name. The calling script file is suspended during processing of the subscript and 
control returns on subscript’s end of file. This directive supports modular scripting in 


NPSNET-OASIS. 


3. Script Chain 


Linking of one input script file to another requires the script directive 
SCRIPT_CHAIN. The required argument is a string containing the script file name. After 
the chained script file is successfully opened, the other script file is closed. This directive 


is useful for combining small script files into one large script. 


4. Script Repeat 


Similar to a counter-controlled loop, the script directive SCRIPT_REPEAT allows 
scripts to be processed repeatedly. There are three arguments for SCRIPT_REPEAT - 
iterations, object number adjustment, and timestamp adjustment. Iterations are values for 
the number of times repeating the same script. Object number adjustment is the increment/ 
decrement value for all 3D icon identification numbers. Similar to the scnpt option 
SCRIPT_TIME_ADJUSTMENT, timestamp adjustment is the increment/decrement of 
timestamps for each repeated script event. All script events in script chains and script calls 
are affected by SCRIPT_REPEAT. This directive is useful for repeating the entire script, 


or repeating a short series of script events. 


5. Script_Timestamp 


SCRIPT_TIMESTAMP, with the selected string as argument, is used to change time 


reference in script processing. The default time reference for NPSNET-OASIS system is 


Z| 


“relative”. The other option is “‘absolute’’.Relative time reference is for all timestamp’ 
adjustments based on input script start time. Absolute time reference is for all timestamp 


adjustments based on system start time. 


6. Script Time Adjustment 


Changing event timestamps throughout the script requires 
SCRIPT_TIME_ADJUSTMENT to be inserted prior to selected statements. An argument 
in timestamp format, is used for adding to event timestamps. To stop timestamp 


adjustments, requires another SCRIPT_TIME_ADJUSTMENT and an argument of zero. 


7. Script Time Factor 

Another option for adjusting timestamp, is the use of SCRIPT_TIME_FACTOR. 
With a floating-type numeric argument, SCRIPT_TIME_FACTOR, provides the time 
factor percentage for each event timestamp. This option is useful for incrementing or 
decrementing speed of script processing. For example, the value of 2.0 causes two seconds 


of script time to be four seconds of wall clock time. 


8. Script Delay 

There are two arguments required for SCRIPT_DELAY - timestamp and delay type. 
Delay type is either “absolute” or “relative”. In absolute mode, the current script is 
suspended until the time specified by the timestamp. In relative mode, the current script 1s 


suspended for the time duration specified by the timestamp. 


9. Script Location 

Upon initialization, the NPSNET-OASIS system assigns the default UTM gridzone 
and MGRS with strings “10S” and “DN” respectfully. Defaults will be assigned when an 
UTM gridzone and/or MGRS are not included in the event position. Replacing one or both 


system defaults requires SCRIPT_LOCATION to be used in the script. 


pay 


10. Script File Write 


Script objects recorded to an output script file include script events and script 
comments. There are no script options or blank lines. SCRIPT_FILE_WRITE provides 
animators the capability to include any type of script statements in a recorded script. If there 


is no output script file, then an error message is displayed. 


11. Script_ Message 


While developing software, programmers include statements in their source code for 
tracing and debugging. In NPSNET-OASIS, animators have the same capability by 
allowing script messages to be displayed on a standard output device. Messages can include 
any text desired by the animator. One suggestion is to use script messages prior to selected 
script events. Messages with information on upcoming events provide advanced warning 


of what to expect in visual simulation. 


Ze 


IV. IMPLEMENTATION OF NPSNET-OASIS 


A. OVERVIEW 

The current NPSNET system runs across the entire Silicon Graphics, Inc. (SGI) IRIS 
4D line [Ref. 10]. NPSNET-OASIS was developed with no graphics function calls, thus 
allowing application on various types of platforms including non-graphics workstations. 
Networking allows the different platforms to interact on other workstations in the 
Graphics and Video Laboratory. 

For autonomous vehicle control, the network harness process of NPSNET enables 
NPSNET-OASIS to provide scripted autonomous players in visual simulation [Ref. 10]. 
The network harness uses Ethernet TCP/IP multicast packets designed for the NPSNET 
system. The purpose of this process is to listen to the packets broadcast on the network and 
to build an internal model of the state of the world from those packets. Script events from 
NPSNET-OASIS are transformed to message packets and broadcasted via the network 


harness. In addition, packets received are transformed and recorded to an output script. 


B. DATA STRUCTURES 

The data structures required for the script event and message packet transformations 
are contained in Appendices I through K. Currently in NPSNET, only vehicle script 
events are used for autonomous vehicle control. As further development of NPSNET 


continues, other script events are integrated to allow enhanced modeling of the world. 


C. NPSNET-OASIS NETWORK INTERFACE 
As shown in Figure 4.1, NPSNET-OASIS is integrated into NPSNET by coupling 
with the NPSNET-OASIS network interface. The network interface provides the 
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Figure 4.1 NPSNET-OASIS Network Interface 


synchronization in playbacks and recordings of NPSNET-OASIS scnpts. Using the 
required data structures, transformations of all script event message packets are processed 


in the network interface. 


1. Internal Data Structures 
Several NPSNET-OASIS network interfaces can interact with NPSNET with each 
containing its own internal data structures for representing the state of the world. Referred 


to as the local state of the world, the data structure contains all locations and vehicle types 
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for NPSNET-OASIS. Additionally, another internal data structure is used for indicating 
which vehicle icons are recorded on script. First time script events of vehicle icons 
require the script event VEHICLE_ACTIVATE to be recorded on script. Playback of 
scripts requires VEHICLE_ACTIVATE to set the vehicle attribute alive for the vehicle 
icon to be active in NPSNET. The network interface updates the local data structures prior 


to each message broadcast and prior to recording on script. 


2. Message Packets 

Currently there is only one type of message packet used in NPSNET for scripted 
autonomous players - vehicle update. Each vehicle script event is processed as a vehicle 
update regardless of event type. The encoding of the message packet is described in 
Appendix K. 

There are three types of message packets received from the network - stop script, 
time synchronization, and vehicle update. Stop script message enables the NPSNET- 
OASIS network interface to detach from the network. Time synchronization message 
assigns the initial start ttme of NPSNET. NPSNET-OASIS sets all start times of script 
files and script system to the time specified in the message. Wehicle update message is 


used to update the local state of the world and to record the script event. 


3. Operation of Network Interface 

Referring to Figure 4.2, the NPSNET-OASIS network interface is operational until 
end of input script file or a stop script message packet. If the network interface was 
initialized with no input script file, then a stop script message is required. Prior to reading 
script events, the network is checked for incoming message packets. When message 
packets exist, the local state of the world is updated and the transformed script events are 


recorded. All script events from the input script file are transformed to message packets 
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and sent to the network. System time for NPSNET-OASIS is based on the user clock 


reference. 


a] 


void MonitorNpsnetNetwork() { 

AddProcessToNetwork(); 

SetSystemStartTime(StartTicks / HZ, StartTicks % HZ); 

while(ActiveNetworkInterface) { 
CurrentTicks = (times(&SysTimes) - StartTicks); 
ReceiveAndProcessMessages(); 
if(InputScriptExists && ActiveNetworkInterface) { 

ReadAndProcessScriptEvent(CurrentTicks, VehicleArray): 


switch(GetScriptResult()) { 
case END_OF_SCRIPT: 
InputScriptExists = FALSE; 
if(!OutputScriptExists) 
ActiveNetworkInterface = FALSE; 
break; 
case SCRIPT_VALID: 
WriteScnptMessage(GetIconIDQ, GetEventID()); 
SendUpdateMessage(GetIconIDQ)); 
break; 
case SCRIPT_ERROR: 
case SCRIPT_IN_DELAY: 
case NO_SCRIPT_EVENT: 
default: 
Break, 
} // end switch 


} // endif 
} // endloop 
DetachProcessFromNetwork(); 
// end MonitorNpsnetNetwork 


Figure 4.2 Network Interface Monitor Routine 
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V. CONCLUSIONS AND RECOMMENDATIONS 


A. SUMMARY AND CONCLUSION 


The NPSNET-OASIS system has fulfilled the initial requirement of providing tools to 
record and playback scripts. The NPSNET-OASIS network interface provides users of 
NPSNET the capability to generate scripted autonomous players in visual simulations. 
The study in applying object-oriented methodologies in a practical design such as 
NPSNET-OASIS was beneficial for extensibility and reusability of existing source code. 
This was proven when the network interface for NPSNET-OASIS was built on top of a 
script system. As new software developments evolve in the Graphics and Video 


Laboratory, changes can be made in NPSNET-OASIS with little modifications. 


B. LIMITATIONS 


There are two limitations in NPSNET-OASIS. First, using the classes of NPSNET- 
OASIS requires C++ throughout software development. Existing software in the Graphics 
and Video Laboratory such as NPSNET must be converted to C++ in order to fully 
integrate NPSNET-OASIS in code. The second limitation is that NPSNET is currently 
unable to use all the script events in NPSNET-OASIS. The data structures for NPSNET 
are limited in containing the information for all types of continuous and transient events. 
In addition, the capabilities for transient events such as collisions and explosions are still 
under development. Current design of the NPSNET-OASIS network interface permits only 


continuous events of vehicle icons, such as vehicle heading and velocity changes. 


C. FUTURE DIRECTIONS 


Current implementations of NPSNET-OASIS are in executable load modules with no 
graphics functions. Execution of load module requires typing the module name at the 


command prompt. There are no output displays other than error messages generated during 
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processing and recording of scripts. Future effort could be placed on developing some 
interactive tool for using the script tools of NPSNET-OASIS, such as a graphics script 
editor or a syntax directed editor. 

The NPSNET-OASIS network interface is implemented only for the SGI IRIS 
graphics workstations. Porting the software to other platforms should be an easy matter. 
Suggestion is to modify the source code of NPSNET-OASIS for providing scripted 


autonomous players from a different platform. 
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APPENDIX A 
NPSNET-OASIS Script Events, Results, and Errors 


Note: Back slashes ’V in syntax or examples indicate continuation on the same line. 


Vehicle Events 
VEHICLE ACTIVATE 
VEHICLE ACTIVATE <vehicle number> <type description> <heading> \ 
<velocity> <UTM coordinates> <elevation> \ 
<timestamp> 


Description - New vehicle icon activated for visual simulation. 


Example- VEHICLE ACTIVATE 200 M1 235.0 5.0 1234567890 0.0 5:0.0 


VEHICLE DEACTIVATE 


VEHICLE DEACTIVATE <vehicle number> <timestamp> 


Description - Vehicle icon deactivated from visual simulation. 


Example- = VEHICLE _DEACTIVATE 200 5:0.0 


VEHICLE MODIFICATION 


VERICLE MODIFICATION <vehicle number> <component name> \ 
<rotation X direction> |\ 
QroOtatmonmy wClreertton > w<arotetion Z direction> \ 
<translation X direction> 
<translation Y direction> \ 
<translation Z direction> <UTM coordinates> \ 
<elevation> <timestamp> 


Description - Vehicle icon is modified by changing the degrees of freedom on one of it’s 


components. 


oll 


Example- = =VEHICLE_MODIFICATION 200 turret 10.0 10.0 10.0 25.0 25.0\ 
25.0 1234567890 0.0 5:0.0 


VEHICLE PITCH 


VEHICLE mad Lee <vehicle number> <pitch angle> <UTM coordinates>\ 
<elevation> <timestamp> 


Description - Pitch angle of vehicle icon is changed. Negative values indicated downward 
angle and positive values indicate upward angle. 


Example- = VEHICLE PITCH 200 10.0 1234567890 0.0 5:0.0 


VEHICLE ROLL 


VEHICLE ROLL <vehicle number> <roll angle> <roll direction> |\ 
<UTM coordinates> <elevation> <timestamp> 


Description - Roll angle of vehicle icon is changed. The direction of the roll is either 
*stbd’, ’port’, or none’. Direction ’none’ indicates a roll angle of 0.0. 
Examples- VEHICLE ROLL 200 10.0 stbd 1234567890 0.0 5:0.0 


VEHICLE ROLL 200 1070 pore vi23456/7390 0 70 ea 


VEHICLE ROLE 200 0.0 none 123456759080 .0 200 


VEHICLE POSITION 


VEHICLE POSITION <vehicle number> <UTM coordinates> <elevation> \ 
<timestamp> 


Description - The position of vehicle icon is updated. 


Examples- VEHICLE POSITION 200 79A-DN-1234567890 0.0 5:0.0 
VEHICLE _POSITION 200 79A-1234567890 0.0 5:0.0 


VEHICLE POSITION 200 DN-1234567890 0.0 5:0.0 


o2 


VEHICLE HEADING 


VEHICLE _ HEADING <vehicle number> <heading> <UTM coordinates> |\ 
<elevation> <timestamp> 


Description - The heading of vehicle icon is changed. All headings are from 0.0 to 359.9 
degrees relative to North. For NPSNET, degrees are required to be in radians. 


Example- VEHICLE HEADING 200 270.0 79A-DN-1234567890 0.0 5:0.0 


VEHICLE SPEED 


VEHICLE SPEED <vehicle number> <velocity> <UTM coordinates> |\ 
<elevation> <timestamp> 


Description - The velocity of vehicle icon is changed. All velocities are in kilometers per 


hour. 


Example- VEHICLE SPEED 200 10.0 79A-DN-1234567890 0.0 5:0.0 


VEHICLE TRAIL 


VEHICLE TRAIL <vehicle number> <trail description> |\ 
<bound area X direction> |\ 
<bound area Y direction>\ 
—poundeareaeyecitection> <offset X direction> \ 
<orfset Y direction> <offset 2 direction> \ 
<UTM coordinates> <elevation> <timestamp> 


Description - The trail of vehicle icon is activated for visual simulation. Trails such as dust 


or wake requires attributes for bounding area for size and vehicle offset. 


Example- VEHICLE TRAIL 200 mediumdust 10.0 10.010.0 0.0 0.0 0.0\ 
1234567890 0.0 5:0.0 


VEHICLE COLLISION 


VEHICLE COLLISION <vehicle number> <description result> |\ 
<UTM coordinates> <elevation> <timestamp> 


ae) 


Description - This event is a transient event indicating vehicle icon collision with another « 


icon. 


Example- VEHICLE_COLLISION 200 destroyed 79A-DN-12345678900.05:0.0 


VEHICLE EXPLOSION 


VEHICLE EXPLOSION <vehicle number> <explosion description> \ 
<bound area X direction> |\ 
<bound area Y direction> \ 
<bound area Y direction> <UTM coordinates> \ 
<elevation> <timestamp> 


Description - This event is a transient event of a vehicle icon explosion. Attributes 
required are explosion type and bounding area for explosion. 


Example- = VEHICLE _EXPLOSION 200 largescale 10.0 10.0 10.0 1234567890\ 
Oui0 eS 20-00 


VEHICLE FLAMING 


VEHICLE_FLAMING <vehicle number> <description of fire \ 
<bound area X direction> |\ 
<bound area Y direction>\ 
<bound area Y direction> <offset X direction> \ 
<offset Y direction> <offset Z Gireceion- 
<UTM coordinates> <elevation> <timestamp> 


Description - This event is a transient event of a vehicle icon on fire. Attributes required 


are type of flames, bounding area of the flames, and the vehicle offset to the flames. 


Example - VEHICLE FLAMING 200 mediumflame 10.0 10.0 10.0 0.0 0.0 0.0\ 
1234567690 sO. 00 


VEHICLE SMOKING 

VEHICLE _SMOKING <vehicle number> <description of smoke> \ 
<bound area X direction> \ 
<bound area Y direction> |\ 
<bound area Y direction> <offset X direction> \ 
<offset Y direction> <offset Z direction> |\ 
<UTM coordinates> <elevation> <timestamp> 
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Description - This event is a transient event of a vehicle icon emitting smoke. Attributes 


required are smoke type, bounding area of the smoke, and the vehicle offset to the smoke. 


Example- = VEHICLE_SMOKING 200 mediumsmoke 10.0 10.0 10.0 0.0 0.0 0.0\ 
Hz 4 507090 040, 5-0-0 
VEHICLE DESTROYED 


VEHICLE DESTROYED <vehicle number> <UTM coordinates> <elevation> |\ 
<timestamp> 


Description - Not removed from visual simulation, the vehicle icon is destroyed. 


Example- = VEHICLE DESTROYED 1234567890 0.0 5:0.0 


VEHICLE FUEL 
VEHICLE FUEL <vehicle number> <fuel amount> <timestamp> 


Description - The fuel state is changed on a vehicle icon. Amount of fuel left in vehicle 
icon 1s indicated in liters. 


Example- VEHICLE FUEL 200 10.0 5:0.0 


VEHICLE AMMUNITION 


VEHICLE AMMUNITION <vehicle number> <weapon name> <weapon rounds> \ 
<timestamp> 


Description - The ammunition state is changed on a vehicle icon. Weapon rounds of 


weapon name indicate current number assigned to the vehicle icon. 


Example- = VEHICLE AMMUNITION 200 turret 10 5:0.0 


VEHICLE UPDATE 


VEHICLE UPDATE <vehicle number> <vehicle status> <heading> \ 
<velocity> <pitch angle> <roll angle> \ 
<roll direction> <UTM coordinates> <elevation> \ 
<timestamp> 
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Description - Update status on a vehicle icon. 


Examples- VEHICLE_UPDATE 200 inmotion 260.0 10.0.0 0.0 none 456789\ 
O A one 


VEHICLE STATUS QUERY 


VEHICLE STATUS_QUERY <vehicle number> <timestamp> 


Description - This event queries status of a selected vehicle icon. 


Example- = VEHICLE_STATUS_QUERY 200 5:0.0 


n Even 
WEAPON LAUNCH 


WEAPON_LAUNCH <weapon number> <source id> <description>\ 
<heading> <heading type> <velocity> |\ 
<pitch angle> <UTM coordinates> <elevation> |\ 
<timestamp> 


Description - Weapon is launch from a source vehicle icon with initial velocity and 
headings. Headings are indicated in relative ’R’ or absolute ’A’. 


Examples - WEAPON _LAUNCH 300 200 sm-2 260.0 A 500.9 45.0 456789 3.0\ 
SOO 
WEAPON LAUNCH 300 200 sm-2 260.0 R 500.9 45.0 456789 3.0\ 
Sig eed 


WEAPON IMPACT 


WEAPON _IMPACT <weapon number> <source id> <UTM coordinates>\ 
<elevation> <timestamp> 


Description - Weapon impact terminating weapon icon. 


Example- = =WEAPON_IMPACT 300 200 456789 3.0 5:0.0 
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WEAPON EXPLOSION 


WEAPON EXPLOSION “Wedponmnumbet- = =source 2a> <UTM coordinates> \ 
<elevation> <timestamp> 


Description - Weapon explosion terminating weapon icon. 


Example - WEAPON _EXPLOSION 300 200 456789 3.0 5:0.0 


WEAPON UPDATE 

WEAPON UPDATE <weapon number> <source id> <weapon status> |\ 
<heading> <heading type> <velocity> \ 
<pitch angle> <UTM coordinates> <elevation> |\ 


<timestamp> 


Description - Update status on a weapon icon. 
Examples- WEAPON_UPDATE 300 200 active 260.0 A 300.0 35.0 456789 3.0 5:0.0 


WEAPON UPDATE 300 200 active 260.0 R 300.0 35.0 456789 3.0 5:0.0 


WEAPON STATUS QUERY 
WEAPON_STATUS_ QUERY <weapon number> <source id> <timestamp> 


Description - This event queries status of a selected weapon icon. 


Examples- WEAPON _STATUS_QUERY 300 200 5:0.0 


Miscellaneous Object Events 
OBJECT ACTIVATE 


OBJECT ACTIVATE <object number> <object description> |\ 
<UTM coordinates> <elevation> <timestamp> 


Description - New miscellaneous object icon activated for visual simulation. 


Example- OBJECT ACTIVATE 250 building 1234567890 5:0.0 
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OBJECT DEACTIVATE 
OBJECT DEACTIVATE <object number> <timestamp> 


Description - Miscellaneous object icon deactivated from visual simulation. 


Example- OBJECT DEACTIVATE 250 5:0.0 


OBJECT COLLISON 


OBJECT GOLLEsTCn <object number> <description result>\ 
<UTM coordinates> <elevation> <timestamp> 


Description -This event is a transient event indicating miscellanious object icon collision with 


another icon. 


Example- OBJECT_COLLISION 250 destroyed 79A-DN-1234567890 0.0 5:0.0 


OBJECT EXPLOSION 


OBJECT EXPLOSION <object number> <explosion description> | 
<bound area X direction> \ 
<bound area Y direction> |\ 
<bound area Y direction> <UTM coordinates> \ 
<elevation> <timestamp> 


Description - This event is a transient event of a miscellaneous object icon explosion. 
Attributes required are explosion type and bounding area for explosion. 


Example - OBJECT_EXPLOSION 250 largescale 10.0 10.0 10.0 12345678 0.0 5:0.0 


OBJECT FLAMING 


OBJECT_FLAMING <object number> <description of fire> |\ 
<bound area X direction> |\ 
<bound area Y direction> \ 
<bound area Y Girection. —-oLlset «so cemlon a 
<offset Y directhion> <ofisepeczeartece cl a 
<UTM coordinates> <elevation> <timestamp> 
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Description - This event is a transient event of a miscellaneous object icon in flames. 
Attributes required are flame type, bounding area of the smoke, and the object offset of the 
flames. 


Example- OBJECT FLAMING 250 largescale 10.0 10.0 10.0 0.0 0.0 0.0\ 
tz 450 709070.0 520.0 


OBJECT SMOKING 


OBJECT _SMOKING <object number> <description of smoke> |\ 
<bound area X direction> |\ 
<bound area Y direction> |\ 
<bound area Y direction> <offset X direction> |\ 
<offset Y direction> <offset Z direction> |\ 
<UTM coordinates> <elevation> <timestamp> 


Description - This event is a transient event of a miscellaneous object icon emitting smoke. 
Attributes required are smoke type, bounding area of the smoke, and the object offset of the 
smoke. 


Example- OBJECT SMOKING 250 mediumsmoke 10.0 10.0 10.0 0.0 0.0 0.0\ 
izeaoe7es0 0.0 5!0.0 


OBJECT_UPDATE 


OBJECT_UPDATE <object number> <object status> |\ 
<UTM coordinates> <elevation> <timestamp> 


Description - This event queries status of a selected miscellaneous object icon. 


Examples- OBJECT_UPDATE 250 active 1234567890 0.0 5:0.0 


OBJECT STATUS QUERY 
OBJECT STATUS QUERY <object number> <timestamp> 


Description - This event queries status of a selected miscellenous object icon. 


Example- OBJECT _STATUS QUERY 250 5:0.0 


She 


Environment Events 
ENVIRONMENT ACTIVATE 
ENVIRONMENT ACTIVATE <environment object number> <type description> |\ 
<heading> <velocity> <UTM coordinates> \ 


<elevation> <timestamp> 


Description - New environment effect icon is activated for visual simulation. 


Example- = =ENVIRONMENT_ ACTIVATE 400 cloud 345.0 5.0 1234567890 5:0.0 


ENVIRONMENT DEACTIVATE 
ENVIRONMENT DEACTIVATE <environment object number> <timestamp> 


Description - Environment effect icon of vehicle number is deactivated from visual 
simulation. 


Example-  =ENVIRONMENT DEACTIVATE 400 5:0.0 


SCRIPT ABORT 


SCRIPT ABORT 


Description - Normal termination of NPSNET-OASIS requires all statements in the input 
script file to be processed. However, the animator has the option to terminate the script by 
inserting SCRIPT_ABORT. This script directive has no arguments. When encountered, all 
script files are closed, and a script result of END_OF_SCRIPT is returned to the system. 


Example - SCRIPT ABORT 


SCRIPT CALL 
SCRIPT ICALL <filename for script call> 


Description - The directive SCRIPT_CALL is a subscript call, similar to a procedure call 
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in a high-level programming language. The argument for this directive is a string 
containing the script file name. The calling script file is suspended during processing of the 
subscript. Only one script is processed at any given time. Script file control returns to the 
caller on subscript’s end of file. This directive supports modular scripting in NPSNET- 
OASIS. 


Example - SCRIPT CALL script-1.ml 


SCRIPT CHAIN 


Seki Pl CHAIN <filename for script chaining> 


Description - Linking of one input script file to another requires the script directive 
SCRIPT_CHAIN. The required argument is a string containing the script file name. After 
the chained script file is successfully opened, the other script file is closed. This directive 
is useful for combining small script files into one large script. 


Example - SCRIPT _CHAIN script-1.ml 


SCRIPT REPEAT 


SCRIPT REPEAT <iterations> <object number adjustment> \ 
<time adjustment> 


Similar to a counter-controlled loop, the script directive SCRIPT_REPEAT allows scripts 
to be processed repeatedly. There are three arguments for SCRIPT_REPEAT - iterations, 
object number adjustment, and timestamp adjustment. Iterations are values for the number 
of times repeating the same script. Object number adjustment is the increment/decrement 
value for all 3D icon identification numbers. Similar to the script option 
SCRIPT_TIME_ADJUSTMENT, timestamp adjustment is the increment/decrement of 
timestamps for each repeated script event. All script events in script chains and script calls 
are affected by SCRIPT_REPEAT. This directive is useful for repeating the entire script, 


Or repeating a short series of script events. 


4] 


Example - SCRIPT REPEAT 10 1 2:0.0 

SCRIPT LOCATION 

SCRIPT LOCATION <new default UTM gridzone and/or MGRS> 

Description - Upon initialization, the NPSNET-OASIS system assigns the default UTM gridzone 
and MGRS with strings “10S” and “DN” respectfully. Defaults will be assigned when an UTM 
gridzone and/or MGRS are not included in the event position. Replacing one or both system 
defaults, requires SCRIPT_LOCATION to be used in the script. 

Examples - sCRIPT LOCATION 79A-DN 


SCRIPT LOCATION 79A 


SCRIPT LOCATION DN 


SCRIPT TIMESTAMP 

SCRIPT TIMESTAMP <time reference for script timestamps 

Description - The default time reference for NPSNET-OASIS system is “relative”. The other 
option is “absolute”. SCRIPT_TIMESTAMP, with the selected string as argument, is used to 
change time reference in script processing. Relative time reference is for all timestamp adjustments 
based on input script start time. Absolute time reference is for all timestamp adjustments based on 
System start time. 


Examples - SCRIPT TIMESTAMP relative 


SCRIPT TIMESTAMP absolute 


SCRIPT TIME FACTOR 

SCRIPT TIME FACTOR <time factor value> 

Description - Another option for adjusting timestamp, is the use of SCRIPT_TIME_FACTOR. 
With a floating-type numeric argument, SCRIPT_TIME_FACTOR, provides the time factor 


percentage for each event timestamp. This option is useful for incrementing or decrementing speed 


of script processing. 
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Example - SCRIPT TIME FACTOR 0.5 


SCRIPT TIME ADJUSTMENT 


SGRIPT TIME ADJUSTMENT <timestamp> 


Description - Changing event’ timestamps throughout the = script requires 
SCRIPT_TIME_ADJUSTMENT to be inserted prior to selected statements. An argument in 
timestamp format, is used for adding to event timestamps. To stop timestamp adjustments, requires 
another SCRIPT_TIME_ADJUSTMENT and an argument of zero. 


Example- SCRIPT TIME ADJUSTMENT 10:0.5 


SCRIPT DELAY 
SCRIPT DELAY <timestamp> <type of script delay> 


Description - There are two arguments required for SCRIPT_DELAY - timestamp and delay type. 
Delay type is either “absolute” or “‘relative’’. In absolute, the current script is suspended until the 
time specified by the timestamp. In relative, the current script is suspended for the time duration 


specified by the timestamp. 


Examples - SCRIPT DELAY 10:0.0 relative 


Deh PEemhLAY 25:24.0 absolute 


SCRIPT FILE WRITE 


SCRIPT FILE WRITE <SenipE li ne> 


Description - Script objects recorded to an output script file include script events and script 
comments. There are no script options or blank lines. SCRIPT_FILE_WRITE provides animators 
the capability to include any type of script statements in a recorded script. If there is no output script 
file, then an error message is displayed. 


Example - SCRIPT FILE WRITE SCRIPT MESSAGE end of script 
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SCRIPT MESSAGE 
SCRIPT MESSAGE <message> 


Description - While developing software, programmers include statements in their source code for 
tracing and debugging. In NPSNET-OASIS, animators have the same capability by allowing script 
messages to be displayed on a standard output device. Messages can include any text desired by 
the animator. One suggestion is to use script messages prior to selected script events. Messages 
with information on upcoming events provide advanced warning of what to expect in visual 
simulation. 


Example- SCRIPT MESSAGE End Of Script 
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Script Results 
SCRIPT ERROR 
SCRIPT_ERROR is returned from NPSNET-OASIS when an input/output file error occurred or a 
script statement is invalid. File errors occur if unable to open or close a file. Invalid script 
statements include invalid syntax for script comments, invalid procedural operators, invalid 


arguments for a procedural operator, and invalid formats for arguments. 

END OF SCRIPT 

On end of script, which includes processing of all input script files, a result of END_OF_SCRIPT 
is returned. 

SCRIPT IN DELAY 

SCRIPT_IN_DELAY is returned when processing of script files are suspended. 


SCRIPT VALID 


For a result of SCRIPT_VALID, script statements are of valid syntax. 


NO_ SCRIPT EVENT 
An option for classes built on top of NPSNET-OASIS, NO_SCRIPT_EVENT is returned when’ 
script processing is suspended or a script event is not ready for return. Used in the NPSNET- 
OASIS network interface, NO_SCRIPT_EVENT is returned when the script event is not ready for 


multicast. 
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Script Errors 
NPSNET-OASIS can only have one main input script file assigned. If another is assigned then the 
following 1s displayed: 


SCRIPT ERROR: Only one main script permitted to be open. 


The following message is displayed if the main script file does not exist. Possible errors can 
include file does not exist, or some characters of the file name are of upper case. 


SCRIPT ERROR: Unable to open main script file ’filename’. 


When NPSNET-OASIS is unable to close a script file a message is displayed. 


SCRIPT ERROR: Unable to close 'filename’. 


There are error messages for invalid file opens for script chaining or script call. In addition, another 
line is displayed informing the line number and file name of the script file containing the script 
option. Messages are as follows: 


SCRIPT ERROR: Unable to open script ‘filename’ for chaining. 


SCRIPT ERROR: Unable to open script ‘filename’ for script call. 


Script events to be recorded require an output script file. If the file does not exist, then the 
following error message is displayed: 


SCRIPT ERROR: No output file opened for script generation. 
For recording scripts, the following message is displayed if a procedural operator of a script event 


does not exist. 


SCRIPT ERROR: Invalid event for script generation. 
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If the script statement is not a script comment or a valid script procedural operator, then the 

following message is displayed: 
SCRIPT ERROR: Invalid OASIS Procedural Operator. 

For a valid script comment, the start symbol ’/*’ and the termination symbol ’*/’ must exist. In 

addition, no nesting of comments are permitted. When the termination symbol is encountered by 

the script processor, the rest of the script line is checked for invalid characters. Messages are as 

follows: 


SCRIPT ERROR: Invalid characters after script comment end symbol. 


SCRIPT ERROR: Encountered another script comment beginning. 
SCRIPT ERROR: Script comment with no end symbol. 

When script statements contain valid procedural operator, chances are that required arguments are 
missing, some arguments are of invalid format, or too many arguments. If this should happen, then 


an error message is displayed followed by another line containing line number and name of input 


script file. There is a separate error message for each procedural operator. Messages are as 


follows: 
SCRIPT ERROR: Invalid parameters for environment_activate. 
SCRIPT ERROR: Invalid parameters for environment_deactivate. 
SCRIPT ERROR: Invalid parameters for vehicle activate. 
SCRIPT ERROR: Invalid parameters for vehicle deactivate. 
SCRIPT ERROR: Invalid parameters for vehicle_modification. 
SCRIPT ERROR: Invalid parameters for vehicle _ pitch. 
wommr! BARC, — iva Daramecers for venicle roll. 
SCRIPT ERROR: Invalid parameters for vehicle position. 
SCRIPT ERROR: Invalid parameters for vehicle heading. 
SCRIPT ERROR: Invalid parameters for vehicle_speed. 
SCRIPT ERROR: Invalid parameters for vehicle trail. 
SCRIPT ERROR: Invalid parameters for vehicle collision. 
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vehicle_explosion. 
vehicle flaming. 
vehicle smoking. 
vehicle destroyed. 
vehicle fuel. 

vehicle ammunition. 
vehicle update. 
vehicle status_query. 
object activate. 
object_deactivate. 
object_collision. 
object_explosion. 
object_flaming. 
object smoking. 
object_update. 

object _status_query. 
script time fae@cor. 
script _time_adjustment. 
script delay. 
SCE1DiEMaGeOrL, 
SCrUpEn Cale: 

Seri pewenal n. 
script repeat. 
script timestamp. 
SCripL location. 
weapon launch. 
weapon impact. 
weapon explosion. 
weapon update. 


weapon status query. 


APPENDIX B 
NPSNET-OASIS Sample Scripts 


[RR KR KK KK KR KKK KIRK OK RK KK OR OO RR OR OR Ok kK kk KK ek 


File: Seri ptm 

DESCuADE LON: Sample script of two M-1 tanks in motion 
Host Id Number: S00 

Simulator: NPSNET on IRIS VGX Workstation 

buthor: Phillip West 


BOR KKK KKK IKK RR IRR RR RR RR IRR ROKR ke / 


/* Assign timestamp reference relative to start time of input script */ 
SehiE? TIMESTAMP relative 


/* Assign default UTM gridzone and MGRS */ 
Serie ls LOCATION eS bh 


/* Assign time factor of 50 percent for all timestamps */ 
Sent) (alive FACTOR C5 


/* Assign time adjustment value of 10 seconds for all timestamps */ 
SCRIPT TIME ADJUSTMENT 10.0 


/* Activate clouds with velocity 5.0 km/h, heading 270.0 west */ 
ENVIRONMENT ACTIVATE DO > OUmeroud 270.0 5250734556783 1000.0 30.0 


pemaeceivate two M-l tanks */ 
VEHICLE ACTIVATE 500001 Mis 090.0 -40.0 344955.0.0 40. 
VEHICLE ACTIVATE 50700027 MiIw0S0.0 40-0 345958 0.0 45. 


> es = | 


/* Change headings of M-1 tanks */ 
VEHICLE HEADING 50100 0 ie Sms 44801 0.08220. 0 
VEHICLE HEADING BOmROOGzZ=120.0 3448035 0.0 2:5.0 


/* Change velocities of M-1 tanks */ 


VEHICLE SPEED BUMOOUteo 0 s4a4670 0.0 6:0.0 
VEHICLE SPEED SOOO tmomOnmo4467750.0 7:25.0 

/*x M-1 tanks passing by a building */ 

OBJECT ACTIVATE 5010004 Building 344701 0 8:10.0 


OBJECT DEACTIVATE 5010004 9:40.0 


/* Script message for advance warning of upcoming script events */ 
SCRIPT MESSAGE Activating column of jeeps 


/* Script call for column of jeeps */ 
SCRIPT CALL script-2. jeeps 
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/* Continue script with next script file */ 
SCRIPT CHAIN SCripi 2s n 


[RKEKKKKK KKK KKK KK KK RK RK KK RK KK kK Kk RK RR RK KK RK KK KR 


File: SCEIpt=1 mE 

Description: Sample script of two M-1 tanks in motion 
Host Id Number: S02 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


RK IK KI I TOR I TRI TIO IO kk  / 


/* M-1 tanks passing by a palm tree */ 
OBJECT ACTIVATE 9010003 PalmTree 345700° 0. 22.050 
OBJECT DEACTIVATE 5010003 22 ae5r0 


/* Change velocities of M-1 tanks */ 
VEHICLE SPEED 5010001 5.0 345670 0.0 26:0.0 
VEHICLE SPEED 5010001520 9384560 720 Une oa 


/* Deactivate M 1 tanks */ 
VEHICLE DEACTIVATE SOL0O00IN 29: 4520 
VEHICLE DEACTIVATE SO010002 29: 50150 


/* Deactivate column of jeeps */ 
SCRIPT CALE script-3. jeeps 


/* Continue script with another scenario */ 
SCRIPT_CALL SCEIPtsa...1iea 


/* Deactivate clouds */ 
ENVIRONMENT DEACTIVATE 5010500 45:0.0 


/* Script delay for duration of 2 minutes prior to termination */ 
SCRIPT DELAY 230.0; absoture 


/* Write to output script file message for next script processing */ 
SCRIPT FILE WRITE SCRIPT MESSAGE End of Script 


/* script message for end of script */ 
SCRIPT MESSAGE *** DEMO COMPLETE *** 


/* Terminate script */ 
SCRIPT ABORT 
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File: script-2. jeeps 

Description: Sample script of activating multiple jeeps 
Host Id Number: SOW 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


KHKKKKKKKKKKK KK KKK KK KKK KKK RK KK Kk Kk kk kk kk kk kok kok kkk kkk kok kok kk ok kok kok kk kk / 


/* Activate jeep vehicle */ 
VEHICLE ACTIVATE 5010010 Jeep 090.0 40.0 345678 0.0 10:0.0 


/* Repeat script for 10 iterations with total 11 separate vehicles */ 
SCRIPT REPEAT Ve ab bette 


[RK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK RK KKK KKK RK KKK KKK KKK KKK KKK KKK KR KK KK 


File: script-3.jeeps 

Description: Sample script of deactivating multiple jeeps 
Host Id Number: S/0)1) 

Simulator: NPSNET on IRIS VGX Workstation 

Author: Phillip West 


KKK KKK KK KKK KKK KKK KK KK KKK KK KKK KKK KK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KK KK KK / 


/* Deactivate jeep vehicle */ 
VEHICLE DEACTIVATE SOLOOT0RZ29..0-.0 


/* Repeat script for 10 iterations with total 11 deactivate jeeps */ 
SCRIPT REPEAT TiGigl. 12/0 
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File: SCript—47114 

Description: Sample o£ a SCript oCf£ a flying aemeerare 
Host Id Number: 20 

Simulator. NPSNET on IRIS VGX Workstation 

Author: Phillip West 


FH KK I KK IK FI IO IOI III RIOT IO IORI IO TO III IOI IOI KIO III Ik ke / 


/* Activate F-14 aircraft in flight status */ 
VEHICLE ACTIVATE 5010110 B14 090.0 540.0 345678 200020 sur07e 


/* Aircraft roll to port 10 degrees */ 
VEHICLE _ROLL 5010110 10.0 port 344677 1000.0 SiarUe0 


/* Aircraft level roll to 0 degrees */ 
VEHICLE ROLL 5010110 0.0 none 344676 996575342 56-5 


/* Sea sparrow launch from F-14 */ 
WEAPON LAUNCH 5010210 5010110 seasparrow 240.0 R 400.0 -10.0\ 
344675 995.67 36.040 


/* Weapon impact on surface */ 
WEAPON_IMPACT SO0T0Z TO S0r 010634267 0M07 Us oens > 


/* Weapon exploded on surface */ 
WEAPON EXPLOSION 5010210 5020110 3426700 Cs0weo vey 


/* Deactivate F-14 */ 
VEHICLE DEACTIVATE 5BOMOTLO VAS oe 


Sz 


APPENDIX C 
Class Definition of ScriptProcessor 


/ /assosesssaaaassssasssssessssssssesssssasssssssssssesssssssssssssssss= 
// Classtype: ScriptProcessor 

// Derived from: VehicleProcessor, WeaponProcessor, 

e/ MiscObjectProcessor, EnvironmentProcessor, 

Wa ScriptOptionProcessor 

// Base for: OasisSystem 

// Remarks: This class provides the mechanism to read script 

J/ files and process script events for valid script 

i objects and comments. 

jf f SSS sss 3335555555585 85 S55 SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS5= 


class ScriptProcessor : private VehicleProcessor, 
private WeaponProcessor, 
private MiscObjectProcessor, 
private EnvironmentProcessor, 
private ScriptOptionProcessor { 


eublac: 
ScriptProcessor(); PCOnsizruclor 
~ScriptProcessor(); // Destructor 


// Member functions for ScriptProcessor 
long ReadScriptObject (ScriptObjecté& Script); 
// Reads next script object from input script file and 
// returns null if error occurs. 
SourceScriptFile* GetScriptFile(); 
// Returns reference pointer of current input script file. 
Vol SetScriptFile(SourceScriptFile* Scriptfile); 
// Assigns current script file for script processing. 
void SetUtmScriptDefaults (char *Gridzone, char *Mgrs); 
// Assigns default gridzones and mgrs for event positions. 
ScriptProcessor* Instance () ; 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
protected: 
SourceScriptFile* CurrentScriptFile; 
// Current input script file. 
private: 
long SetupScriptLine(char *Line); 
// Removes excess blank spaces and converts uppercase 
// characters to lower case. Returns SCRIPT _COMMENT 
// if script line is the beginning of a comment block. 
long ScanForBlankLines(char *Line); 
// Returns null for non-blank lines. 
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long DetermineEvent (ScriptObject& Script, char* Line); 


// Determines procedural operator for script object, 
// calls group processor for procedural operator. 
// null if. script verrorece urs 

}; // end class ScriptProcessor 


and 
Returns 
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APPENDIX D 
Class Definition of ScriptGenerator 


ff SssSsss SSS SSS SSS SSS SS SSS SSS SSS SSS SS SS SSS SSS SSS SS SSS SSS SSS SS SSSESS=== 
// Classtype: ScriptGenerator 
// Derived from: OasisSystemObject 
// Base for: OasisSystem 
// Remarks: This class provides the mechanism in writing script 
vu files. 
Ls SSS SS SS SSS SS SS SSS SSS SS SS SSS SSS SSS SSssSsSSSsSSsss= 
class ScriptGenerator : public OasisSystemObject { 
public: 
ScriptGenerator(); Py aGonsecuctcr. 
~ScriptGenerator(); // Destructor. 


// Member functions for ScriptGenerator 

long OpenOutputFile (char *Name) ; 
// Opens output script file and returns TRUE for successful 
// file open. 

long WEelbeSeripeOogect (SCriptObjecté Script); 
// Writes script object to script file and returns TRUE for 
// successful file write. 

Fong WriteScriptLine (char *Line) ; 
V7 eviGeteesn SCE; pe oD ject touscript file and returns TRUE for 
// successful file write. 

long CloseOutputFile(); 
// Closes output script file and returns result of file 
jf 7elcse. 

ScriptGenerator* Instance(); 
// Returns reference pointer of instance. 

virtual char *ClassName(); 
// Returns class identification string. 

protected: 

DestinationScriptFile OutFile; 

// Current destination script file. 
private: 

void WriteVehicleEvent (VehicleEvent& Vehicle); 
// Writes script object of vehicle event to output script 
// file. 

Vowel WriteWeaponEvent (WeaponEvent& Weapon) ; 

// Writes script object of weapon event to output script 
y/ file. 

void WriteMiscObjectEvent (MiscObjectEvent& MiscObject); 
// Writes script object of miscellaneous object event to 
jjpgemeput serapt file. 

void WriteEnvironmentEvent (EnvironmentEvent& Environment) ; 
// Writes script object of environment event to output 
j//eeeceree file. 


oD 


void WriteComment (ScriptComment& Comment) ; 
// Writes script comment block to output script file. 
}; // end class ScriptGenerator 
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class TimeKeeper 


APPENDIX E 
Class Definition of TimeKeeper 


mm ec we a a a we a ww wr we 
ee ee 


Classtype: TimeKeeper 

Derived from: OasisSystemObject 

Base for: OasisSystem 

Remarks: This class provides the functions to keep track of 
time, and convert to and from script object 
timestamps. 


oivon loner 


TimeKeeper (); 
TimeKeeper (long Reference) ; 
~TimeKeeper (); 


we a ws ww wm nk i i ee i i i i i SS SS 
ee ee a mw Se SS SSS 


public OasisSystemObject { 


V7 (CGonseruckor 
J) Constructor 
// Destructor 


// Member functions for TimeKeeper 


LOG 
void 
void 
void 
void 
void 


void 


void 


void 


void 


long 


GetClockReference (); 

// Returns clock reference of timekeeper. 
SetClockReference (long Reference) ; 

// Assigns clock reference of timekeeper. 
StartSystemTime () ; 

// Saves time of system start. 

Stare inputocriptTime () ; 

J/eseaves time Of Start for input script. 
StartOutputScriptTime (); 

// Saves time of start for output script. 
SetSystemStartTime (long Seconds, long Microseconds) ; 

// Assigns system start time. 

Seclmpurceripteotarerime (long Seconds, long Microseconds) ; 
//shssrogns stare tame for anput Script file. 
SetOutputScriptStartTime (long Seconds, long Microseconds) ; 
// serous Start time for output script file. 
CurrentSystemTimestamp(ScriptEventé& Event); 

// Assigns timestamp of Script object to current system 
// time (Absolute or Relative). 
ScriptToSystemTimestamp (ScriptEventé& Event,long Reference) ; 
// Modifys timestamp of Script object to reflect time 

// cveference to system time. 

SystemToScriptTimestamp (ScriptEvent& Event,long Reference) ; 
// Assigns timestamp of script object to reflect reference 
// to start of system time or start of input script file. 
SetScriptDelay (ScriptEvent& Delay, long Reference) ; 

// Assigns time to disable script delay based on type of 
// delay. Absolute delay is based on system start time. 
// Relative is based on duration of delay. 
ActiveScriptDelay (); 

// Returns TRUE if script delay is still active. 
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TimeKeeper* Instance() ; 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class¥igentwercation String. 
private: 
long ClockReference; 
// Time reference for time keeper. 
TimeValue System Starttime; 
// Start time of system. 
TimeValue InputScript_ Starttime; 
// Start time of input script. 
TimeValue OutputScript Starttime; 
// Stare time of Cwepue scrips 
TimeValue End_Of DelayTime; 
// Time to release script delay. 
void ConvertToTimestamp (TimeValue *time, ScriptEvent& Event); 
// Converts system time to script object timestamp. 
}; // end class TimeKeeper 
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APPENDIX F 
Class Definition of OasisSystem 


/ /aasennnasasnaasasasssesssssssssssssesesssssessssesssssessssssss25=25 
// Classtype: OasisSystem 

// Derived from: TimeKeeper, ScriptProcessor, ScriptGenerator 

// Base for: OasisScriptSorter, OasisScriptPreprocessor 

// Remarks: This class provides the mechanism for reading and 
as Writing Scriptefiles. All? script options are 

Vd processed internally. 

ff SSS SS SSS SS SS SS SS SS SSS SS SSS SSS SSS SS SSS SSS SS SSS SS SS SSS SS SSS SS SSS SSS SSS 


class OasisSystem : private TimeKeeper, 


Public: 


private ScriptProcessor, 
private ScriptGenerator { 


OasisSystem(); //meonst ructos 
Sass oy Sem () Ong me rock KhChOmcnce 7/7 CONSE ruclor gaiuse SYSTEM CLOCK 


// for reference in system time 
// access, or use USER_CLOCK for 
// time provide by the user. 


~OasisSystem() ; // destructor 
// Member functions for OasisSystem 


long 


hong 


long 


long 


long 


long 


double 


OpenInputScriptFile(char *Name) ; 

// Opens script file for input. Returns TRUE for successful 
// file open. 

OpenOutputScriptFile(char *Name) ; 

// Opens script file for output. Returns TRUE for 

// successful file open. 

GeESCTIpE Ob JeCce (SeripLtObj eEct& Script); 

// Requires ScriptObject as argument for script event I/O. 
// The script object is returned with result of either - 
// SCRIPT_ERROR, SCRIPT VALID, END_OF_SCRIPT, 

// SCRIPT IN DELAY, or NO SCRIPT EVENT. 
PatSeripteob ject (ScriptObject& Script) ; 

//SViEEees SCripesecbjece equCULpUutmscripe file and returns 
// TRUE for successful file write. 

CligsetnputScriptkile () > 

// Closes input script file and returns result of TRUE for 
// successful file close. 

CloseOutputScriptFile(); 

// Closes input script file and returns result of TRUE for 
jjmsaccesstul sfiteJc lose. 

GetTimeFactor(); 

// Returns time factor for computing timestamps for all 

// script objects. 

SetTimeFactor(double Factor); 

// Assigns time factor for computing timestamps for all 

[Ff SSCEIDE Ob JECtS. 


3S, 


Vvoud 


vod 


SetSystemStartTime (long Seconds, long Microseconds) ; 

// Only used in USER_CLOCK time reference, the system 

// starttime is altered to match total seconds and 

// microseconds. Start times for input and output script 
// files will be the same for system start time. 
DisableScriptMessagesAndDelays (); 

// Sets flag for no script messages to be displayed and 
// no script delays to be activated 


OasisSystem* Instance(); 


// returns reference pointer of instance. 


virtual char *ClassName(); 


protected: 


// veturns™class identiiiecation string, 


SourceScriptFile *CurrentInputFile; 


private: 
long 


Long 
long 
double 
double 


Tong 


Vou 


Long 


long 


long 


Fone 


// Reference to current input scriptfile 


EndOfinputScripe, 

// Boolean flag for end of script file. 

DelayActive; 

// Boolean flag for active script delay. 
MessagesAndDelays; 

// Initially TRUE allowing script messages and delays 
TimeAdjustment; 

// Amount of time to adjust script timestamps. 
TimeFactor; 

// Time factor for each computed timestamp. 
TimeReference; 

// Time reference for determining type of timestamp for 
// script object. ABSOLUTE TIME for assigning timestamps 
// relative to system start time. RELATIVE TIME for 

// assigning timestamps relative to input script start 

// time. 

ModifyScriptObject (ScriptEventé& Event); 

// Modifys script object in computing timestamps according 
// to time reference time adjustment, and time factor. 
ProcessScriptOption (ScriptOption& Option); 

// Process script option for OASIS. Returns either 

// SCRIPT_VALID or END_OF_SCRIPT. 

DelayScript (ScriptOptions Optron), 

// Assigns script delay based on type of reference in time 
// delay. If absolute, delay is aborted when system time 
// matches time of delay. If relative, time of delay is 
// added to time of receiving script object for reference. 
ChainScript (ScriptOprioné) Ope wore 

// Closes current script file and opens another. Returns 
// Mali Git- Grrorwoccurs. 

CallSceript (ScriptOptione Cpcien)., 

// Calls script file as a subroutine and returns back to 
// calling script file) Returme@nmiiegerrer occur. 

// dauring file open. 
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long RepeatScript (ScriptOption& Option); 
// Repeats current script file for number of iterations. 
}; // end class OasisSystem 
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APPENDIX G 
Class Definition of OasisScriptSorter 


[ / SSS SSS SSS SSS SSS SS SSS SSS SSS SS SS SSS SSS SSS SS SSS SSS SSS SSS SSS SSS SS SSS SSE 
// Classtype: OasisScriptSorter 
// Derived from: OasisSystem 
// Base for: none 
// Remarks: This class provides the mechanism to sort script 
ia objects of source script files and writes back to a 
// destination script file. The qsort function of 
Ti, ANSI C is used for sorting. 
[ / SSS SSS 3 SS SSS SS SSS SS SS SS SS SS SS SS SSS SSS SSS SS SSS SSS SS SSS SS SSS SSS SS SS S55 
class OasisScriptSorter : private OasisSystem { 
pubic. 
OasisScripesorter or //*CONnSEEUCECrE 
~OasisScriptSorter(); // DEStructes 
// Member functions for OasisScriptSorter 
long PerformSort (char *Source, char *Destination) ; 
// Performs sort of source script file and generates sorted 
// script to a destination script file. Source and 
// Destination can be the same file name. 
OasisScriptSorter* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 


a 


Vong ReadScriptFile(char *Source); 
// Reads script file into sort array and returns TRUE for 
// valid script file or FALSE for invalid Scripe, file 
long WriteScriptFile(char *Destination); 
// Writes script objects from sort array to destination 
// seript file. Returns TRUB wt valadisceript welte: 
long NumberOfEntries; 
// Returns number of script objects in sort array. 
SCript Sources Serie. 
// Array for Sorting» Scriptwcenccts. 
void CreateSortArray (); 
// Creates sorting array. 
void DestroySortArray (); 
// Destroys sorting array. 
double GetTimestamp(ScriptObject& Source) ; 
// Returns timestamp in total seconds and microseconds from 
// Seri pt ob yece 
double PreviousTimestamp; 
// Timestamp of previous script object. 
Long PreviousObjectWasAComment ; 
// Boolean flag for previous script object. 
// end OasisScriptSorter 


62 


APPENDIX H 
Class Definition of OasisScriptPreprocessor 


|] inne 
// Classtype: OasisScriptPreprocessor 

// Derived from: OasisSystem 

// Base for: none 

// Remarks: This class provides a mechanism to check source 

ey script files errors prior to use. 

f fSSSssS SSS Ss SSS SSS SSS SSS SS SSsSsS SSS SsresseessasessSSSSSSSSSSSSSS=5=== 


class OasisScriptPreprocessor : private OasisSystem { 
Public: 
OasisScriptPreprocessor (); Vie COnstrucrorn 
~OasisScriptPreprocessor(); // Destructor 
// Member functions for OasisScriptPreprocessor 
long PerformErrorChecking(char *Source); 
// Reads script file and displays to standard output device 
// BOLvaliBeELrorsoein script file. 
OasisScriptPreprocessor* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
}; // end OasisScriptPreprocessor 
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APPENDIX I 
Class Definitions of Script Events and Attributes 


f /SSSS SS SS SSS SS SS SSS SSS SS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS 
// Classtype: ObjectHeading 
// Derived from: EventAttribute 
// Base for: VehicleEvent, WeaponEvent, EnvironmentEvent 
// Remarks: This class provides functions for object headings 
yy in degrees. 
/ /SSSS SSS SS SSS SS SS SSS SSS SSS SS SSS SS SSS SSS SS SSS SS SSS SSS SSS SS SS SSS SSS SSS 
class ObjectHeading : public EventAttribute { 
public: 

ObjectHeading(); // Constructor 

~Obj ectHeading(); // Destructor 


// Member functions for ObjectHeading 
void SetHeading (float Value); 

// Assigns object heading in degrees. 
float GetHeading(); 

// Returns object heading in degrees. 
void SetHeadingType(char Type); 

// Assigns heading type. 
char GetHeadingType (); 

// Returns heading type as a string (absolute or relative). 
ObjectHeading* Instance(); 

// Returns reference pointer of instance. 
virtual char *ClassName() ; 

// Returns class identification string. 

private: 

float Heading; 

// Heading of object in degrees. 
char HeadingType; 

// Heading in Relative direction ‘r’ 

// or Absolute direction ‘a’ 

}; // end class ObjectHeading; 


f f/SSSSSS SSS SSS SS SSS SSS SSS SSS SSS SSS SS SS SS SSS SSS SSS SS SSS SS SSS SSS SS SSS SS 
// Classtype: Object Velocity 
// Derived from: EventAttribute 
// Base for: VehicleEvent, WeaponEvent, EnvironmentEvent 
// Remarks: This class provides functions for object velocity 
Ly in kilometers per hour. 
/ / SSS SS SSS SS SS SS SSS SS SSS SSS SSS SSS SSS SSS SS SS SSS SSS SS SSS SSS SS SSS SSS SSS 
class ObjectVelocity : public EventAttribute { 
pub iie- 

ObjectVelocity(); // Conmstuuctor 

~ObjectVelocity(); // Destructor 


// Member functions for ObjectVelocity 
float GetVelocity(); 

// Returns object velocity in km/h. 
void SetVelocity (float Value); 

// Assigns object velocity in km/h. 
ObjectVelocity* Instance (); 


// Returns reference pointer of instance. 


virtual char *ClassName(); 
// Returns class identification string. 


private: 


V3 


float Velocity; 


// Velocity of object in kilometers per hour. 


// end class ObjectVelocity; 


f f SSS SS SS SSS SS SS SS SSS SS SSS SSS SS SSS SSS SSS SSS SS SS SSS SS SS SS SSS SSS SSS SSS 
// Classtype: ObjectPitchAngle 
// Derived from: EventAttribute 
// Base for: VehicleEvent, WeaponEvent 
// Remarks: This class provides the functions for object pitch 
T/ angle in degrees. 
/ /aaaaeas5555595555555555555555555555555555295555555555555555529555=5=== 
class ObjectPitchAngle : public EventAttribute { 
public: 
ObjectPitchAngle(); // SCONSTENCTOL 
~ObjectPitchAngle(); // Destructor 


// Member functions for ObjectPitchAngle 
float GetPitchAngle(); 


// Returns object pitch angle in degrees. 


void SetPitchAngle (float Angle); 


// Assigns object pitch angle in degrees. 


ObjectPitchAngle* Instance (); 


// Returns reference pointer of instance. 


virtual char *ClassName(); 
// returns class identification string. 


private: 


1 


float PitchAngle; 
// Object’s pitch angle in degrees. 


// end class ObjectPitchAngle; 


[ /SSS SESS SS SS SS SSS SS SSS SS SSS SSS SSS SSS SS SS SS SS SSS SS SSS SS SSS SS SSS SSS SST 
// Classtype: ObjectRoll 
// Derived from: EventAttribute 
// Base for: VehicleEvent 
// Remarks: This class provides functions for object roll. 
f SSS S SSS S55 SS SS SS SSS SSS SSS SS SS SS SS SS SS SSS SSS SSS SS SSS SS SS SS SSS SSS SST 
class ObjectRoll : public EventAttribute { 
public: 
Sbject.or 1 ():- Jf Constructor 
~ObjectRoll (); // Destructor 
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// Member functions for ObjectRoll 
float GetRollAngle(); 
// Returns roll angle in degrees. 
void SetRollAngle(float Angle); 
// Assigns roll angle in degrees. 
char *GetRollDirection(); 
// Returns roll direction of either "port" or “stbd" 
void SetRollDirection(char *Direction); 
// Assigns roll direction. 
ObjectRoll* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
float RollAngle; 
// Roll angle of object (in degrees) 
char *RollDirection; 
// Direction of pitch (pomemonresema 
}; // end class ObjeceRc mr, 


/ SSS SSS SSS SS SSS SS SS SS SS SS SSS SSS SSS SSS SS SS SSS SSS SS SS SSS SS SSS SSS SSS SSS= 
// Classtype: ObjectComponent 
// Derived from: EventAttribute 
// Base for: VehicleEvent 
// Remarks: This class provides functions for object component. 
ih All movements of object component are represented 
// by the six degrees of freedom for translation and 
ee rotation. 
f /SSSSSSS SSS Ss SSS SaaS SSS SS SSS SSS SSS SS SSS SS Ses SSS SSS SSS SSS SSS SSS SSS SSS= 
class ObjectComponent : public EventAttribute | 
pubilise: 

ObjectComponent (); //sGonstructor 

~ObjectComponent () ; // Destructor 


// Member functions for ObjectComponent 
char *GetComponentName (); 
// Returns name of object component. 
void SetComponentName (char *Name) ; 
// Assigns name to object component. 
float GetComponentRotation(long Axis); 
// Returns component rotation in the requested axis. 
void SetComponentRotation(float Xval, float Yval, float Zval); 
// Assigns component rotation in the X, Y, and Z axis. 
float GetComponentTranslation(long Axis); 
// Returns component translation in the requested axis. 
void SetComponentTranslation(float Xval, float Yval,float Zval); 
// Assigns component translation in the X, Y, and Z axis. 
ObjectComponent* Instance (); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
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private: 
char *ComponentName; 
// Component name of object. 
float ComponentRotation [XYZ]; 
// Degrees of freedom in rotation. 
float ComponentTranslation[XYZ]; 
// Degrees of freedom in translation. 
}; // end class ObjectComponent; 


[ / SSS SSS SSS SS SSS SS SS SS SSS SSS SSS SSS SS SS SS SSS SS SSS SS SSS SSS SS SS SS SSS SSSE5 
// Classtype: ObjectWeapon 
// Derived from: EventAttribute 
// Base for: VehicleEvent 
// Remarks: This class provides functions for object weapons, 
a Usually components on vehicles. 
[/ [SS SSS SSS SSS SSS SSS SS SS SSS SS SSS SSS SSS SSS SS SSS SS SSS SSS SSS SSS SSS SSS SSS 
class ObjectWeapon : public EventAttribute { 
Ppublemerx 
ObjectWeapon(); WmConstructox 
~ObjectWeapon (); // Destructor 
// Member functions for ObjectWeapon 
long GetWeaponRounds (); 
// Returns number of rounds in weapon. 
Vo rd SetWeaponRounds (long Rounds) ; 
// Assigns number of rounds to weapon. 
Char *GetWeaponName (); 
// Return name of weapon. 
void SetWeaponName (char *Name) ; 
// Assigns name of weapon. 
ObjectWeapon* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 


char *WeaponName; 
// Weapon component name. 
Hong WeaponRounds; 
// Number of rounds in Weapon. 
}; // end class ObjectWeapon 
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// Classtype: ObjectExplosion 
// Derived from: EventAttribute 
// Base for: VehicleEvent, WeaponEvent, MiscObjectEvent 
// Remarks: This class provides functions for object explosions 
/ /SSSSS SS SSS SSS SS SS SS SS SS SSS SS SSS SSS SSS SSS SSS SSS SSS SS SSS SSS SSS SSS SSS SS 
class ObjectExplosion : public EventAttribute { 
public. 
ObjectExplosion(); // (Const wuctor 
~ObjectExplosion (); // Destructor 


// Member functions for ObjectExplosion 
char *GetExplosionDescription (); 
// Returns description of explosion. 
void SetExplosionDescription(char *Description) ; 
// Assign description of object explosion. 
float GetExplosionBoundArea (long Axis); 
// Return coordinate of explosion bound area along 
// requested axis. 
Ole SetExplosionBoundArea(float Xval, float Yval, float Zval); 
// Assign X, Y, and Z coordinates of explosion bound area. 
ObjectExplosion* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
char *ExplosionDescripceion, 
// Descriptive type of explosion. 
float ExplosionBoundArea [XYZ]; 
// Maximum area bound in X, Y, Z coordinates. 
}; // end class ObjectExplosion; 


ff SSS SSS SSS SS SS SS SS SS SS SS SS SSS SSS SSS SSS SSS SS SS SS SSS SSS SS SS SSS SS SS SS SEE 
// Classtype: ObjectFireAndSmoke 
// Derived from: EventAttribute 
// Base for: VehicleEvent, WeaponEvent, MiscObjectEvent 
// Remarks: This class provides functions for all object fire 
ve and smoke events. 
/ fSssss seas SSS SS SS SSS SS SS SS SS SS SS SSS SS SS SS SSS SS SS SS SS SS SSS SSS SSS SSS SSE 
class ObjectFireAndSmoke : public EventAttribute { 
public: 
ObjectFireAndSmoke () ; // Const ruecon 
~ObjectFireAndSmoke () ; // Destructor 


// Member functions for ObjectFireAndSmoke 
char *GetFireAndSmokeDescription (); 
// Returns descriptive type of smoke or fire. 
void SetFireAndSmokeDescription(char *Description) ; 
// Assigns descriptive type of smoke or fire on object. 
float GetFireAndSmokeBoundArea (long Axis); 
// Returns coordinate of requested axis of maximum bound 
// area of smoke or fire. 
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void SetFireAndSmokeBoundArea(float Xval,float Yval,float Zval); 
// Assigns coordinates of X, Y, and Z axis maximum bound 
// area of smoke or fire. 

float GetFireAndSmokeOffset (long Axis); 
// Returns coordinate of requested axis of smoke or fire 
// offset on object. 

void SetFireAndSmokeOffset (float Xval, float Yval, float Zval); 
// Assigns coordinates of X, Y, and Z axis smoke or fire 
// offset on object. 

ObjectFireAndSmoke* Instance ()j; 
// Returns reference pointer of instance. 

virtual char *ClassName(); 
// Returns class identification string. 


private: 


ie 


char *FireAndSmokeDescription; 

// Descriptive type of smoke or flame on object. 
float FireAndSmokeBoundArea [XYZ]; 

// maximum area bound in X, Y, and Z coordinates. 
float FireAndSmokeOffset [XYZ]; 

// Offset coordinates on object. 
// end class ObjectFireAndSmoke; 


[ fSSSSSS SSS SSS SSS SS SS SS SS SSS SS SSS SS SSS SSS SSS SS SS SSS SS SS SS SSS SS SS SSS SSE 
// Classtype: ObjectTrail 
// Derived from: EventAttribute 
// Base for: VehicleEvent 
// Remarks: This@eWass provides functions fiorsobject trails. 
/ /Sssaea sa SSS SSS SSS SSS SSS SSS SSS SS SSS SSS SS SSS SS SS SS SSS SS SS SSS SS SSS SS SSE 
class ObjectTrail : public EventAttribute { 
Publ. ce: 
ObjectTrail(); //e@cnst ructex 
=Ob ect Traima() > // Destructor 


// Member functions for ObjectTrail 
char *GetTrailDescription(); 
// Returns description of object trail. 
iG Gl SetTrailDescription(char *Description) ; 
// Assigns description to object trail. 
float GetTrailBoundArea(long Axis); 
// Returns coordinate of trail bound area along request 
// axis. 
void SetTrailBoundArea (float Xval, float Yval, float Zval); 
// Assigns maximum bound area coordinates for X, Y, and Z. 
float GetTrailOffset (long Axis); 
// Returns coordinate of trail offset along request axis. 
eepuel SetTrailOffset (float Xval, float Yval, float Zval); 
(Assigns object coordinates in X,@Y, and Z for trail 
VegroLt set: 
ObjectTrail* Instance (); 
// Returns reference pointer of instance. 
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virtual char *ClassName(); . 
// Returns class identification string. 
private: 
char *TrailDescription; 
// Descriptive type of object trail. 
float TrailBoundArea [XYZ]; 
// Maximum area bound of trail. 
float TrailOffset [XYZ]; 
// Offset position on object. 
}; // end class ObjectTrail; 


/ / SSS SSS SSS SSS SS SS SSS SS SSS SSS SSS SS SSS SSS SS SS SSS SS SS SSS SSS SS SSS SS SS SSS 
// Classtype: ObjectFuel 
// Derived from: EventAttribute 
// Base for: VehicleEvent 
// Remarks: This class provides functions for object fuel. 
lag Fuel is represented in Liters. 
/ (SS SS SS SS SSS SSS SSS SSS S SS SS SS SSS SS SSS SSS SSS SSS SSS SSS SSS SS SS SSS SSS SSS SS 
class ObjectFuel : public EventAttribute { 
public: 
ObjectFuel (); // CONnStrucror 
~ObjectFuel (); // Destructor 


// Member functions for ObjectFuel 
float GetFuel(); 
// Returns amount of fuel in liters. 
void SetFuel (float Value); 
// Assigns amount of fuel in liters. 
ObjectFuel* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
float Fuel; 
// Fuel state of Object (liters). 
}; // end class ObjectFuel; 


/ / SS SSS SSS SSS SS SS SS SSS SSS SSS SSS SSS SSS SSS SS SS SSS SSS SS SS SS SSS SSS SSS SSSR 
// Classtype: EventObject 
// Derived from: OasisEventObject 
// Base for: VehicleEvent, WeaponEvent, MiscObjectEvent, 
// EnvironmentEvent 
// Remarks: This class provides functions for all event objects 
/ /SSSSS SSS Ss aS SSS SSS SSS SSS SS SSS SS SS SS SSS SSS SS SSS SSS SS SSS SSS SSS SSS SSS SE 
class EventObject : public OasisEventObject { 
publie- 

EventObject (); // Const suctcos 

~EventObject (); // Destructor 
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// Member functions for OasisEventObject 
long ConvertIdFromLongInteger(long Id); 
// Converts a number to host and object identification 
// numbers. 
long ConvertIdToLonginteger(); 
// Returns number representing host and object id numbers. 
long GetHostNumber (); 
// Returns host number of object. 
void SetHostNumber (long Number) ; 
// Assigns host number for object. 
long GetObjectNumber() ; 
// Returns object identification number of object. 
void SetObjectNumber (long Number) ; 
// Assigns object identification number to object. 
char *GetObjectDescription(); 
// Returns object description. 
void SetObjectDescription(char *Description); 
// Assigns description to object. 
char *GetObjectStatus(); 
// Returns descriptive status of object. 
void SetObjectStatus(char *Status); 
// Assigns descriptive status of object. 
EventObject* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName() ; 
// returns class identification string. 
private: 
long ObjectHostNumber; 
// Host identification number of object. 
long ObjectNumber; 
// Object identification number. 
char *ObjectDescription; 
/# Description type of object. 
char *ObjectStatus; 
// Descriptive status of object. 
}; // end EventObject 


/ /SSSSS SSS SSS SS SS SS SS SS SS SS SSS SSS SSS SSS SSS SS SS SS SS SSS SSS SS SS SS SS SS S555 
// Classtype: WeaponSource 
// Derived from: EventAttribute 
// Base for: WeaponEvent 
// Remarks: This class provides functions for weapon source. 
ff SSS SS SS SS SS SSS SS SS SS SSS SS SS SSS SSS SSS SSS SSS SSS SSS SS SS SS SSS SS SSS SSS SSE 
class WeaponSource : private EventAttribute { 
public: 
WeaponSource(); (MBSR s CLUCHOX 
~WeaponSource(); J / Best ructor 


il 


// Member functions for WeaponSource 
EventObject& GetWeaponSource(); 
// Returns source object of weapon. 
void SetWeaponSource (EventObject& Source) ; 
// Assigns source object of weapon. 
WeaponSource* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
EventObject SourceOfWeapon; 
// Source object assocated with weapon. 
}; // end class WeaponSource 


/ / SSS SSS SS SSS SS SSS SS SSS SSS SSS SS SS SSS SSS SSS SSS SSS SSS SSS SSS SS SS SSS SSSSSS 
/ (Glassy pe TimeStamp 
// Derived from: OasisEventObject 
// Base for: ScriptEvent 
// Remarks: This class provides functions for all timestamps. 
/ / SSS S SS SSS SS SS SS SSS SSS SSS SSS SS SS SSS SS SS SSS SSS SSS SSS SS SSS SS SSS SS SSS SSS 
class TimeStamp : public OasisEventObject { 
publixe= 
TimeStamp () ; // Gonstrucroen 
~TimeStamp (); // Destructor 


// Member functions for TimeStamp 
void SetHours (long Value); 
// Assigns hours in timestamp. 
Tong GetHours (); 
// Returns hours in timestamp. 
void SetMinutes(long Value); 
// Assigns minutes in timestamp. 
long GetMinutes (); 
// Returns minutes in timestamp. 
WO wal SetSeconds (long Value); 
// Assigns seconds in timestamp. 
Fone, GetSeconds (); 
// Returns seconds in timestamp. 
void SetMicroseconds (long Value); 
// Assigns microseconds in timestamp. 
long GetMicroseconds (); 
// Returns microseconds in timestamp. 
long StringToTimestamp(char *Timestring) ; 
// Converts timestamp string to hours, minutes, seconds, 
// and microseconds. 
char *TimestampToString(); 
// Returns timestamp as a string. 
TimeStamp* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 


q2 


private: 
ong Hous; 
// Timestamp hours. 
long Minutes; 
// Timestamp minutes. 
long Seconds; 
// Timestamp seconds. 
omg Microseconds; 
// Timestamp microseconds. 
char *TimeString; 
// Timestamp in string format. 
}; // end class TimeStamp 


f (SSS SSS SS SS SS SS SS SS SSS SSS SSS SSS SSS SSS SSS SSS SSS SSS SS SS SS SS SSS SS SS SSS== 
// Classtype: EventPosition 
// Derived from: OasisEventObject 
// Base for: ScriptEvent 
// Remarks: This class provides functions for UTM coordinates 
lo and elevations. 
/ (SSS SSS SSS SS SSS SS SS SSS SS SS SSS SSS SSS SSS SS SSS SS SSS SS SSS SS SSS SS SSS SSS SSS 
class EventPosition : public OasisEventObject { 
public: 

EventPosition (); // Gemstructor 

~EventPosition(); L/eDEsStructoxr 

// Member functions for EventPosition 

void SetGridzone (char *NewGridzone) ; 


// Assigns gridzone of UTM position 
char *GetGridzone(); 
// Returns gridzone of UTM coordinates. 
void SetMgrs(char *NewMgrs) ; 
// Assigns MGRS of UTM coordinates. 
char *GetMgrs(); 
// Returns MGRS of UTM coordinates. 
void SetNorthing(long Value); 
// Assigns Northing of UTM coordinates. 
ong GetNorthing(); 
// Returns Northing of UTM coordinates. 
void SetEasting(long Value) ; 
// Assigns Easting of UTM coordinates. 
Lone GetEasting(); 
// Returns Easting of UTM coordinates. 
void SetElevation(float Value); 
// Assigns elevation. 
float GetElevation(); 
// Returns elevation. 
long StringToUtmPosition(char *Position, char *defaultGZ, 
char *defaultMGRS) ; 
// Extracts UTM coordinates from Position, and returns null 
// if error occurs. Default gridzone and mgrs are required 
// for UTM defaults. 


UE 


long StringToMap(char *map_strg, char *defaultGZ, 
char *defaultMGRS) ; 
// Extracts default UTM gridzone and/or Mgrs, and returns 
// null if error jccemes- 
char *UtmPositiconloc eran (n, 
// Returns UTM coordinates as a string. 
EventPosition* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
char *Gridzone; 
// grid zone of UTM coordinate system 
char BaviGus, 
// mgrs of UTM coordinate system 
long Northing, 
// northing offset of grid zone 
long Easting; 
// easting offset of grid zone 
float Elevation; 
// altitude 
char “Positicnoecune, 
// UTM coordinates in string format 
}; // end class EventPosition; 


// Classtype: ScriptEvent 
// Derived from: EventObject, EventPosition, EventAttribute, 
ae TimeStamp 


// Base for: VehicleEvent, WeaponEvent, MiscObjectEvent, 
1S) EnvironmentEvent, ScriptComment, ScriptOption 
// Remarks: This class is the base for all script events. Each 
Toh script event must have an object, place, and time. 
/ / SSS SSS SSS SSS SS SS SS SS SS SS SSS SS SS SSS SS SSS SS SS SSS SS SS SS SS SSS SSS SSS SSSSS 
class ScriptEvent ; publasesevent@oeaeam, public EventPosition, 
private EventAttribute, public TimeStamp { 

joeveul We < 

SCrIpL Eventi // *GOnst ructor 

~SCriptrventelr // Destructor 


// Member functions for ScriptEvent 
long GetEventType (); 
// Returns type of script event. 
void SetEventType(long Type); 
// Assigns type of script event. 
char *GetEventResult (); 
// Returns descriptive result of event. 
void SetEventResult (char *Result); 
// Assigns descriptive result of event. 
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ScriptEvent* Instance (); 
// Returns reference pointer to instance. 
virtual char *ClassName(); 
// Returns class identification string. 
DErvace; 
long EVenelype,; 
// Type of script event. 
char *EventResult; 
// Description result of event. 
}; // end class ScriptEvent 


f f SSS SSS SSS SSS SS SSS SSS SS SSS SSS SSS SSS SSS SSS SSS SSS SSS SS SSS SS SSSSsSSsS=== 
// Classtype: VehicleEvent 
// Derived from: ScriptEvent, ObjectHeading, ObjectVelocity, 
V7. ObjectPitchAngle, ObjectRoll, ObjectComponent, 
// ObjectWeapon, ObjectExplosion, ObjectFireAndSmoke, 
/7/ ObjectTrail, ObjectFuel 
// Base for: SCriIptOD}ece 
// Remarks: This class is for all vehicle events. 
/ /2oss25555555205555555555555255555555555555555555555555555555555555==== 
class VehicleEvent : public ScriptEvent, public ObjectHeading, 
public ObjectVelocity, public ObjectFuel, 
public ObjectPitchAngle, publve Gb yectRoll, 
public ObjectComponent, public ObjectWeapon, 
public ObjectFireAndSmoke, public ObjectTrail, 
public ObjectExplosion { 
Puolae. 
VehicleEvent (); (7 eeonsenuctor 
~VehicleEvent (); // Destructor 


// Member functions for VehicleEvent 
VehicleEvent* Instance(); 
// Returns reference pointer of instance 
virtual char *ClassName(); 
// Returns class identification string. 
}; // end class VehicleEvent 


/ (SSS SSS SSS SS SS SS SSS SS SSS SSS SS SS SS SSS SSS SSS SSS SSS SS SS SS SSS SSS SS SSS SSS 
// Classtype: WeaponEvent 

// Derived from: ScriptEvent, WeaponSource, ObjectHeading, 

Li} ObjectPitchAngle, 

if ObjectVelocity, ObjectExplosion 

// Base for: ScriptObject 

// Remarks: This class is for all Weapon events. 

/ (SSS SSS SSS SSS SSS SS SSS SS SSS SS SS SSS SS SSS SS SSS SSS SS SSS SS SS SSS SS SS SSS SSS 
Class WeaponEvent : public ScriptEvent, public WeaponSource, 


public ObjectHeading, public ObjectPitchAngle, 
public ObjectVelocity, public ObjectExplosion { 
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public. , 
WeaponEvent (); / 7 Gonst mactor 
~WeaponEvent (); // Destructor 
// Member functions for WeaponEvent 
WeaponEvent* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
}; // end class WeaponEvent 


// Classtype: MiscObjectEvent 

// Derived from: ScriptEvent, ObjectFireAndSmoke, ObjectExplosion 
// Base for: SCrIptObJecer 

// Remarks: This class is for all miscellaneous object events. 


class MiscObjectEvent : public ScriptEvent, public ObjectFireAndSmoke, 
public ObjJectExplesieney 


publve- 
MiscObjectEvent (); //@G0nStruccor 
~MiscObjectEvent (); // Destructor 


// Member functions for MiscObjectEvent 
MiscObjectEvent* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName() ; 
// Returns class identification string. 
}; // end class MiscObjectEvent 


/ /Sssss sss ss 5555555 SS SS SSS SS SS SS SSS SS SSS SSS SSS SSS SS SS SSS SS SSS SSS SSS SSE 
// Classtype: EnvironmentEvent 

// Derived from: ScriptEvent, ObjectHeading, ObjectVelocity 

// Base for: ScriptObject 

// Remarks: This class provides is for all environment events. 
ff SSSS SS Ss SS SS SS SS SS 85 SS SS SS SS SSS SSS HS SSS SS SSS SSS SSS SS SS SSS SSS SSS SSS TE 


class EnvironmentEvent : public ScriptEvent, public ObjectHeading, 
public ObjectVelocity { 


public: 
EnvironmentEvent (); / f@@OCNSELUCESL 
~EnvironmentEvent (); // Destructor 


// Member functions for EnvironmentEvent 
EnvironmentEvent* Instance(); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
}; // end class EnvironmentEvent 
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Classtype: ScriptComment 

Derived from: ScriptEvent 

Base for: ScriptObject 

Remarks: This class provides functions for script comments. 


ee ce ce wc wm ae 
ee ee ee me me SS SL a SS ES ee 


ass ScriptComment : public ScriptEvent { 
// Data structure for each comment line 
typedef struct CommentPointer { 


char *Line; // Pointer to comment line. 
struct CommentPointer *Next; // Pointer to next comment line. 
} Comment Link; 
blic: 
ScriptComment (); // Constructor 
~ScriptComment () ; // Destructor 
// Member functions for ScriptComment 
long ReadFromFile (FILE *InputFile, char *Line); 
// Reads from script file rest of comment block. Prior to 
// stunetron, Calle tirstescript fine 12s already read. 
void DeleteComment () ; 
// Removes all comment lines in comment block. 
long GetNumberOfCommentLines(); 
// Returns number of lines in comment biock. 
CommentLink *GetCommentBlock (); 
// Returns reference pointer to comment block. 
Uepke| SetCommentBlock (CommentLink *Block); 
// Assigns reference pointer to comment block. 
ScriptComment* Instance (); 
// Returns reference pointer of instance. 
virtual char *ClassName (); 
// Returns class identification string. 
ivate: 


long NumberOfCommentLines; 

// Number of lines in comment block. 
CommentLink *Comment; 

// Reference pointer to next comment line. 
// end class ScriptComment 


/ /SSSS SSS SSS SSS SS SS SS SS SS SSS SSS SSS SSS SSS SSS SS SSS SS SSS SS SSS SS SS SS SSS SSE 
// Classtype: ScriptOption 
// Derived from: ScriptEvent 
// Base for: Scilptob ect 
// Remarks: This class provides functions for parameters 
yg associated with script options. 
/ / SSS SSS SS SS SSS SS SS SSS SS SSS SS SS SS SSS SSS SSS SS SS SSS SS SS SSS SS SS SS SSS SS SSE 
SllasesocCEhiptOpeion ~ public ScriptEvent { 
je\ Sto pskatres: 
SeriptoOpe vom |): j/ Constructor 
Seria eOotl on () // Destructor 
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// Member functions for ScriptOption 
double GetScriptTimeFactor(); 
// Returns Script) timeetactou. 
vod SetScriptTimeFactor(double Factor); 
// Assigns script time factor. 
double GetScriptTimeAdjustment (); 
// Returns script time adjustment. 
void SetScriptTimeAdjustment (double Adjustment) ; 
// Assigns script time adjustment. 
char *GetDelayType(); 
// Returns script delay type. 
vorg SetDelayType(char *Type); 
// Assigns script delay type. 
char *GetTimeReference (); 
// Returns script time reference. 
void SetTimeReference (char *Reference) ; 
// Assigns time reference for assigning script timestamps. 
char *GetScriptLine(); 
// Returns script line or message. 
void SetScriptLine(char *Line); 
// Assigns script line or message. 
char *GetScriptFilename(); 
// Returns filename of script file. 
void SetScriptFilename(char *Name) ; 
// Assigns filename of script file. 
long GetScriptRepeatValue (); 
// Returns script repeat value of iterations. 
void SetScriptRepeatValue (long Value); 
// Assigns script repeat value of iterations. 
long GetScriptObjectNumberIncrement () ; 
// Returns script object no. increment. 
void SetScriptObjectNumberIncrement (long Value); 
// Assigns script object number increment. 
ScriptOption* Instance (); 
// Returns reference pointer of instance. 
virtual char *ClassName(); 
// Returns class identification string. 
private: 
char *DelayType; 
// Delay type in relative or absolute. 
char *TimeReference; 
// Time reference in relative or absolute. 
char *S¢Greptiine; 
// Reference pointer for script line or message. 
char *ScriptFilename; 
// Filename of script file. 
long RepeatValue; 
// Number of repeats for script file. 
long ObjectNumberIncrement; 
// Object number increment for each iteration. 
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double TimeFactor; 


// Time factor for computing timestamps. 
double TimeAdjustment; 


// Time adjustment for computing timestamps. 
ieee / end class. ScriptOption 
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APPENDIX J 
Class Definition of ScriptObject 


[ / SSS SSS SS SS SSS SSS SS SS SSS SS SS SS SS SS SS SS SS SSS SS SS SSS SS SS SS SSS SS SS SSS SSS 
// Classtype: ScriptObject 

// Derived from: VehicleEvent, WeaponEvent, MiscObjectEvent, 

17] EnvironmentEvent, ScriptOption, ScriptComment 

// Base for: none 

// Remarks: This class provides functions for accessing script 
Wa events. 

/ [SSS SS SSS SSS SS SS SS SS SS SS SSS SS SS SS SSS SS SS SSS SS SS SSS SSS SS SSS SSS SS SSS SSE 


Class ScriptObject : public VehicleEvent, 
public WeaponEvent, 
public MiscObjectEvent, 
public EnvironmentEvent, 
public SéGrEipEOpt ton, 
public ScriptComment { 


buble: 
ScriptObjece. /ymGenstructor 
~“SCrEiptObject a. // DESEGUCE OLE 


// Member functions for ScriptObject 
Tong GetScriptEventType (); 

// Returns type of script event. 
Vou SetScriptEventType(long Type); 

// Assigns type of script event. 
VehicleEventé& GetVehicleEvent (); 

// Returns reference of vehicle event. 
WeaponEventé GetWeaponEvent (); 

// Returns reference of weapon event. 
MiscObjectEvent& GetMiscObjectEvent (); 

// Returns reference of misc object event. 
EnvironmentEventé GetEnvironmentEvent (); 

// Returns reference of environment event. 
ScriptOptionsé GetSenr:seopetome:, 

// Returns reference of script option. 
ScriptCommenté& GetScriptComment () ; 

// Returns reference of script comment. 
ScriptObject* Instance(); 

// Returns reference pointer of instance. 
virtual char *ClassName(); 

// Returns class identification string. 

private: 

long ScriptEventType; 

// Type of event for script object. 

}; // end class ScriptObject 
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APPENDIX K 
NPSNET-OASIS Network Interface 


The following NPSNET data structure is used for sending vehicle updates over the net. 
Attributes marked with an asterisk are used in the vehicle update message packet. 


Struct vehpostype { 


int vehtype; * 
ante CONeEols: * 
ee gunfire; * 
ert alive; * 
aly te rounds, 
iietie deadframes; 
int Eo lima ntervalay 
PiLoat posits); * 
evel, 
lookatpt [3], 
POOkKEYOmpt [3] > 
Floated rection, * 
viewdirection, * 
elev, * 
gunelev, * 
speed, * 
EOi, 
Piseeh, 
gas, 


Golly range, 
}; // end structure 


The following is an example of the transformation of a VEHICLE_ACTIVATE script 
event to a data structure in the local state of the world in NPSNET-OASIS network 
interface. 


Vehicle [Number] .vehtype = LookForObjectTypeNumber ( 
ScriptEvent.GetObjectDescription()); 

Vehicle [Number].control = SCRIPTED; 

Vehicle[Number] .gunfire = 0; 

Vehicle [Number] .alive = TRUE; 

Vehicle [Number] . rounds = DEFAULT VEHICLE ROUNDS; 

Vehicle [Number] .deadframes = 0; 

Vehicle[Number].coll_ interval = 0; 

Vehicle [Number] .pos [X] = ScriptEvent.GetEasting(); 

Vehicle [Number] .pos[Z] = MAX UTM NORTHING - 
ScriptEvent.GetNorthing()); 

Vehicle[Number].elev = ScriptEvent .GetElevation(); 

Vehicle [Number] .eye [X] = 0.0; 
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Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 
Vehicle [Number] 


.eye [YJ 

.eye [Z]) 

. LOoOkar pel 
~LOOKat pet.) 
.-Lookatpt [2] 
-lookfrompt [X] 
-Lookfrompt [Y] 
7 LOOkE rompe lz) 
.direction 
.viewdirection 
elev 

-gunelev 
.speed 

peg oa bell 

Apter 

.gas 

.coll range 


oo oo0c © OC O 


ScriptEvent .GetHeading(); 
OU 
ScriptEvent.GetElevation (); 
O07 
ScriptEvent.GetVelocity (); 
On0;; 

Ol: 

DEFAULT VEHICLE GAS, 

Onur 
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